> ## Documentation Index > Fetch the complete documentation index at: https://docs.runmorph.dev/llms.txt > Use this file to discover all available pages before exploring further. # Authorize a connection ## OpenAPI ````yaml post /v1/connections/{connectorId}/{ownerId}/authorization openapi: 3.0.0 info: version: 1.0.0 title: Swagger API servers: [] security: [] externalDocs: description: View the raw OpenAPI Specification in JSON format url: /swagger.json paths: /v1/connections/{connectorId}/{ownerId}/authorization: post: tags: - Connection summary: Authorize a connection parameters: - schema: anyOf: - type: string enum: - hubspot - pipedrive - salesforce - aircall - gong - attio - dialpad - calendly - xero - chargebee - type: string externalDocs: url: /connectors description: See available connectors. required: true name: connectorId in: path - schema: type: string required: true name: ownerId in: path - schema: type: string format: uri required: false name: redirectUrl in: query - schema: type: string enum: - connect - direct required: false name: mode in: query requestBody: content: application/json: schema: type: object properties: scopes: type: array items: type: string settings: type: object additionalProperties: type: string application/jwt: schema: type: object properties: scopes: type: array items: type: string settings: type: object additionalProperties: type: string text/plain: schema: type: object properties: scopes: type: array items: type: string settings: type: object additionalProperties: type: string responses: '200': description: OK content: application/json: schema: allOf: - type: object properties: object: type: string default: connectionAuthorization - type: object properties: object: type: string enum: - connectionAuthorization default: connectionAuthorization connectorId: type: string ownerId: type: string status: type: string authorizationUrl: type: string required: - connectorId - ownerId - status application/jwt: schema: allOf: - type: object properties: object: type: string default: connectionAuthorization - type: object properties: object: type: string enum: - connectionAuthorization default: connectionAuthorization connectorId: type: string ownerId: type: string status: type: string authorizationUrl: type: string required: - connectorId - ownerId - status text/plain: schema: allOf: - type: object properties: object: type: string default: connectionAuthorization - type: object properties: object: type: string enum: - connectionAuthorization default: connectionAuthorization connectorId: type: string ownerId: type: string status: type: string authorizationUrl: type: string required: - connectorId - ownerId - status '404': description: Not Found content: application/json: schema: type: object properties: error: type: string enum: - MORPH::BAD_REQUEST - MORPH::BAD_CONFIGURATION - MORPH::UNKNOWN_ERROR - MORPH::ADAPTER::CONNECTION_NOT_FOUND - MORPH::ADAPTER::AUTHORIZATION_DATA_INVALID - MORPH::SESSION::EXPIRED - MORPH::SESSION::TOKEN_VALIDATION_FAILED - >- MORPH::CONNECTION::MISSING_REQUIRED_AUTHORIZATION_SETTINGS - MORPH::CONNECTION::AUTH_TYPE_NOT_SUPPORTED - MORPH::CONNECTION::AUTHORIZATION_NOT_FOUND - MORPH::CONNECTION::AUTHORIZATION_RETRIEVE_FAILED - MORPH::CONNECTION::ACCESS_TOKEN_MISSIN - MORPH::CONNECTION::REFRESH_TOKEN_MISSIN - MORPH::CONNECTION::REFRESHING_TOKEN_FAILED - MORPH::CONNECTION::CREATION_FAILED - MORPH::CONNECTION::UPDATE_FAILED - MORPH::CONNECTION::NOT_FOUND - MORPH::CONNECTION::RETRIEVE_FAILED - MORPH::CONNECTION::DELETION_FAILED - MORPH::CONNECTION::PROXY::REQUEST_FAILED - MORPH::CONNECTION::PROXY::BAD_REQUEST - MORPH::CONNECTION::PROXY::UNAUTHORIZED - MORPH::CONNECTION::PROXY::FORBIDDEN - MORPH::CONNECTION::PROXY::NOT_FOUND - MORPH::CONNECTION::PROXY::RATE_LIMIT_EXCEEDED - MORPH::CONNECTION::PROXY::SERVER_ERROR - CONNECTOR::NOT_FOUND - CONNECTOR::OPERATION::NOT_FOUND - CONNECTOR::OPERATION::RESOURCE_NOT_FOUND - CONNECTOR::OPERATION::RESOURCE_ALREADY_EXISTS - CONNECTOR::OPERATION::FIELD_ALREADY_EXISTS - CONNECTOR::OPERATION::BAD_REQUEST - CONNECTOR::OPERATION::SERVER_ERROR - CONNECTOR::RESOURCE_MODEL::NOT_FOUND - CONNECTOR::MAPPER::READ_VALIDATION_FAILED - CONNECTOR::MAPPER::READ_FAILED - CONNECTOR::UNKNOWN_ERROR - CONNECTOR::BAD_CONFIGURATION - CONNECTOR::WEBHOOK::SUBSCRIPTION_FAILED - CONNECTOR::WEBHOOK::UNSUBSCRIPTION_FAILED - CONNECTOR::WEBHOOK::VALIDATION_FAILED - CONNECTOR::WEBHOOK::MAPPER_FAILED - CONNECTOR::WEBHOOKS_NOT_SUPPORTED - WEBHOOK::NOT_FOUND - ADAPTER::WEBHOOK::CREATE_FAILED - ADAPTER::WEBHOOK::RETRIEVE_FAILED - ADAPTER::WEBHOOK::DELETE_FAILED message: type: string default: '' required: - error application/jwt: schema: type: object properties: error: type: string enum: - MORPH::BAD_REQUEST - MORPH::BAD_CONFIGURATION - MORPH::UNKNOWN_ERROR - MORPH::ADAPTER::CONNECTION_NOT_FOUND - MORPH::ADAPTER::AUTHORIZATION_DATA_INVALID - MORPH::SESSION::EXPIRED - MORPH::SESSION::TOKEN_VALIDATION_FAILED - >- MORPH::CONNECTION::MISSING_REQUIRED_AUTHORIZATION_SETTINGS - MORPH::CONNECTION::AUTH_TYPE_NOT_SUPPORTED - MORPH::CONNECTION::AUTHORIZATION_NOT_FOUND - MORPH::CONNECTION::AUTHORIZATION_RETRIEVE_FAILED - MORPH::CONNECTION::ACCESS_TOKEN_MISSIN - MORPH::CONNECTION::REFRESH_TOKEN_MISSIN - MORPH::CONNECTION::REFRESHING_TOKEN_FAILED - MORPH::CONNECTION::CREATION_FAILED - MORPH::CONNECTION::UPDATE_FAILED - MORPH::CONNECTION::NOT_FOUND - MORPH::CONNECTION::RETRIEVE_FAILED - MORPH::CONNECTION::DELETION_FAILED - MORPH::CONNECTION::PROXY::REQUEST_FAILED - MORPH::CONNECTION::PROXY::BAD_REQUEST - MORPH::CONNECTION::PROXY::UNAUTHORIZED - MORPH::CONNECTION::PROXY::FORBIDDEN - MORPH::CONNECTION::PROXY::NOT_FOUND - MORPH::CONNECTION::PROXY::RATE_LIMIT_EXCEEDED - MORPH::CONNECTION::PROXY::SERVER_ERROR - CONNECTOR::NOT_FOUND - CONNECTOR::OPERATION::NOT_FOUND - CONNECTOR::OPERATION::RESOURCE_NOT_FOUND - CONNECTOR::OPERATION::RESOURCE_ALREADY_EXISTS - CONNECTOR::OPERATION::FIELD_ALREADY_EXISTS - CONNECTOR::OPERATION::BAD_REQUEST - CONNECTOR::OPERATION::SERVER_ERROR - CONNECTOR::RESOURCE_MODEL::NOT_FOUND - CONNECTOR::MAPPER::READ_VALIDATION_FAILED - CONNECTOR::MAPPER::READ_FAILED - CONNECTOR::UNKNOWN_ERROR - CONNECTOR::BAD_CONFIGURATION - CONNECTOR::WEBHOOK::SUBSCRIPTION_FAILED - CONNECTOR::WEBHOOK::UNSUBSCRIPTION_FAILED - CONNECTOR::WEBHOOK::VALIDATION_FAILED - CONNECTOR::WEBHOOK::MAPPER_FAILED - CONNECTOR::WEBHOOKS_NOT_SUPPORTED - WEBHOOK::NOT_FOUND - ADAPTER::WEBHOOK::CREATE_FAILED - ADAPTER::WEBHOOK::RETRIEVE_FAILED - ADAPTER::WEBHOOK::DELETE_FAILED message: type: string default: '' required: - error text/plain: schema: type: object properties: error: type: string enum: - MORPH::BAD_REQUEST - MORPH::BAD_CONFIGURATION - MORPH::UNKNOWN_ERROR - MORPH::ADAPTER::CONNECTION_NOT_FOUND - MORPH::ADAPTER::AUTHORIZATION_DATA_INVALID - MORPH::SESSION::EXPIRED - MORPH::SESSION::TOKEN_VALIDATION_FAILED - >- MORPH::CONNECTION::MISSING_REQUIRED_AUTHORIZATION_SETTINGS - MORPH::CONNECTION::AUTH_TYPE_NOT_SUPPORTED - MORPH::CONNECTION::AUTHORIZATION_NOT_FOUND - MORPH::CONNECTION::AUTHORIZATION_RETRIEVE_FAILED - MORPH::CONNECTION::ACCESS_TOKEN_MISSIN - MORPH::CONNECTION::REFRESH_TOKEN_MISSIN - MORPH::CONNECTION::REFRESHING_TOKEN_FAILED - MORPH::CONNECTION::CREATION_FAILED - MORPH::CONNECTION::UPDATE_FAILED - MORPH::CONNECTION::NOT_FOUND - MORPH::CONNECTION::RETRIEVE_FAILED - MORPH::CONNECTION::DELETION_FAILED - MORPH::CONNECTION::PROXY::REQUEST_FAILED - MORPH::CONNECTION::PROXY::BAD_REQUEST - MORPH::CONNECTION::PROXY::UNAUTHORIZED - MORPH::CONNECTION::PROXY::FORBIDDEN - MORPH::CONNECTION::PROXY::NOT_FOUND - MORPH::CONNECTION::PROXY::RATE_LIMIT_EXCEEDED - MORPH::CONNECTION::PROXY::SERVER_ERROR - CONNECTOR::NOT_FOUND - CONNECTOR::OPERATION::NOT_FOUND - CONNECTOR::OPERATION::RESOURCE_NOT_FOUND - CONNECTOR::OPERATION::RESOURCE_ALREADY_EXISTS - CONNECTOR::OPERATION::FIELD_ALREADY_EXISTS - CONNECTOR::OPERATION::BAD_REQUEST - CONNECTOR::OPERATION::SERVER_ERROR - CONNECTOR::RESOURCE_MODEL::NOT_FOUND - CONNECTOR::MAPPER::READ_VALIDATION_FAILED - CONNECTOR::MAPPER::READ_FAILED - CONNECTOR::UNKNOWN_ERROR - CONNECTOR::BAD_CONFIGURATION - CONNECTOR::WEBHOOK::SUBSCRIPTION_FAILED - CONNECTOR::WEBHOOK::UNSUBSCRIPTION_FAILED - CONNECTOR::WEBHOOK::VALIDATION_FAILED - CONNECTOR::WEBHOOK::MAPPER_FAILED - CONNECTOR::WEBHOOKS_NOT_SUPPORTED - WEBHOOK::NOT_FOUND - ADAPTER::WEBHOOK::CREATE_FAILED - ADAPTER::WEBHOOK::RETRIEVE_FAILED - ADAPTER::WEBHOOK::DELETE_FAILED message: type: string default: '' required: - error security: - ApiKeyAuth: [] ApiSecretAuth: [] components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key ApiSecretAuth: type: apiKey in: header name: x-api-secret ````