oauth-apps

Create OAuth connect link

Creates a single-use sign-in link for an end user, valid for 10 minutes.

Send the user to url. After they sign in with the provider, their token is stored under user_id. Use the same ID that your middleware sets in the context path named by the MCP server's oauth.user. The browser then returns to return_url with connic_oauth=connected, denied, or failed added to the query. return_url must match one of the app's return URLs; without it, connic shows a confirmation page.

Required permission: oauth_apps.connect.

post/v1/projects/{project_id}/oauth-apps/{app_id}/connect-links

Request

  • Base URL: https://api.connic.co
  • URL: https://api.connic.co/v1/projects/{project_id}/oauth-apps/{app_id}/connect-links
  • Auth: HTTP bearer

Path parameters

project_idstring uuid required

ID of the project the API key belongs to.

app_idstring uuid required

OAuth app ID from GET /oauth-apps.

Request body

user_idstring required

Your ID for the end user, up to 255 characters. Use the value your middleware sets at the MCP server's oauth.user context path.

return_urlstring nullable

Where the browser returns after sign-in, with connic_oauth set to connected, denied or failed. Must match one of the app's return_urls; omit to show a connic confirmation page.

Response

Successful Response

urlstring required

Single-use sign-in URL to send the end user to.

expires_atstring required

When the link expires, 10 minutes after creation.

Changes

No recorded changes to this operation across all 2 revisions of this API.