Start connector authentication

POST/integrations/connectors/{id}/auth/start

Initiates the authentication flow for a connector that uses OAuth2 or requires interactive credential setup. Returns a redirect URL or auth token to be used in the browser-based OAuth handshake.

Request

Path parameters

Responses

200 Authentication initiation response with redirect URL

Content type application/json, any.

Example

{
  "auth_url": "https://example.salesforce.com/oauth/authorize?client_id=SF_CLIENT_ID&redirect_uri=https%3A%2F%2Fcrm.faciotech.com%2Fintegrations%2Fcallback&scope=read+write&state=abc123",
  "state": "abc123"
}

302 Direct redirect to the OAuth provider if applicable

404 Connector not found

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/integrations/connectors/{id}/auth/start" \
  -H "Accept: application/json"