---
descriptions:
  pipes_authorize_url: The OAuth authorization URL to redirect the user to.
  pipes_authorize:
    slug: 'The slug identifier of the provider (e.g., `github`, `slack`, `notion`).'
    user_id: >-
      A [User](/reference/authkit/user) identifier. This is the user who will
      authorize the connection.
    organization_id: >-
      An [Organization](/reference/organization) identifier. Optional parameter
      to scope the connection to a specific organization.
reference:
  curl:
    - key: pipes_get_authorize_url
      id: pipes_get_authorize_url
      url: /reference/pipes/connected-account/get-authorize-url
      title: '/data-integrations/:slug/authorize'
      type: POST
      parameters:
        - key: slug
          type: string
          description: (pipes_authorize.slug)
        - key: user_id
          type: string
          description: (pipes_authorize.user_id)
        - key: organization_id
          type: string
          description: (pipes_authorize.organization_id)
          optional: true
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: url
              type: string
              description: (pipes_authorize_url)
originalPath: >-
  .tmp-workos-clone/packages/docs/content/reference/pipes/connected-account/get-authorize-url.mdx
---

## Get authorization URL

Generates an OAuth authorization URL to initiate the connection flow for a user. Redirect the user to the returned URL to begin the OAuth flow with the third-party provider.

<CodeBlock referenceId="pipes_get_authorize_url">
  <CodeBlockTab title="Request" file="get-authorize-url-request" />
  <CodeBlockTab title="Response" file="get-authorize-url-response" />
</CodeBlock>