> ## 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. # Create a connection ## OpenAPI ````yaml post /v1/connections/{connectorId}/{ownerId} 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}: post: tags: - Connection summary: Create 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 requestBody: content: application/json: schema: type: object properties: operations: type: array items: type: string enum: - genericCompany::create - genericCompany::retrieve - genericCompany::list - genericCompany::update - genericCompany::delete - genericCompany::fieldRead - genericCompany::fieldWrite - genericContact::create - genericContact::retrieve - genericContact::list - genericContact::update - genericContact::delete - genericContact::fieldRead - genericContact::fieldWrite - genericUser::create - genericUser::retrieve - genericUser::list - genericUser::update - genericUser::delete - genericUser::fieldRead - genericUser::fieldWrite - genericWorkspace::create - genericWorkspace::retrieve - genericWorkspace::list - genericWorkspace::update - genericWorkspace::delete - genericWorkspace::fieldRead - genericWorkspace::fieldWrite - crmOpportunity::create - crmOpportunity::retrieve - crmOpportunity::list - crmOpportunity::update - crmOpportunity::delete - crmOpportunity::fieldRead - crmOpportunity::fieldWrite - crmStage::create - crmStage::retrieve - crmStage::list - crmStage::update - crmStage::delete - crmStage::fieldRead - crmStage::fieldWrite - crmPipeline::create - crmPipeline::retrieve - crmPipeline::list - crmPipeline::update - crmPipeline::delete - crmPipeline::fieldRead - crmPipeline::fieldWrite - crmEngagement::create - crmEngagement::retrieve - crmEngagement::list - crmEngagement::update - crmEngagement::delete - crmEngagement::fieldRead - crmEngagement::fieldWrite - telephonyCall::create - telephonyCall::retrieve - telephonyCall::list - telephonyCall::update - telephonyCall::delete - telephonyCall::fieldRead - telephonyCall::fieldWrite - telephonyCallTranscript::create - telephonyCallTranscript::retrieve - telephonyCallTranscript::list - telephonyCallTranscript::update - telephonyCallTranscript::delete - telephonyCallTranscript::fieldRead - telephonyCallTranscript::fieldWrite - schedulingEventType::create - schedulingEventType::retrieve - schedulingEventType::list - schedulingEventType::update - schedulingEventType::delete - schedulingEventType::fieldRead - schedulingEventType::fieldWrite - schedulingSlot::create - schedulingSlot::retrieve - schedulingSlot::list - schedulingSlot::update - schedulingSlot::delete - schedulingSlot::fieldRead - schedulingSlot::fieldWrite - schedulingEvent::create - schedulingEvent::retrieve - schedulingEvent::list - schedulingEvent::update - schedulingEvent::delete - schedulingEvent::fieldRead - schedulingEvent::fieldWrite - widgetCardView::create - widgetCardView::retrieve - widgetCardView::list - widgetCardView::update - widgetCardView::delete - widgetCardView::fieldRead - widgetCardView::fieldWrite - accountingInvoice::create - accountingInvoice::retrieve - accountingInvoice::list - accountingInvoice::update - accountingInvoice::delete - accountingInvoice::fieldRead - accountingInvoice::fieldWrite - accountingInvoiceLineItem::create - accountingInvoiceLineItem::retrieve - accountingInvoiceLineItem::list - accountingInvoiceLineItem::update - accountingInvoiceLineItem::delete - accountingInvoiceLineItem::fieldRead - accountingInvoiceLineItem::fieldWrite - accountingInvoiceItem::create - accountingInvoiceItem::retrieve - accountingInvoiceItem::list - accountingInvoiceItem::update - accountingInvoiceItem::delete - accountingInvoiceItem::fieldRead - accountingInvoiceItem::fieldWrite additionalProperties: false application/jwt: schema: type: object properties: operations: type: array items: type: string enum: - genericCompany::create - genericCompany::retrieve - genericCompany::list - genericCompany::update - genericCompany::delete - genericCompany::fieldRead - genericCompany::fieldWrite - genericContact::create - genericContact::retrieve - genericContact::list - genericContact::update - genericContact::delete - genericContact::fieldRead - genericContact::fieldWrite - genericUser::create - genericUser::retrieve - genericUser::list - genericUser::update - genericUser::delete - genericUser::fieldRead - genericUser::fieldWrite - genericWorkspace::create - genericWorkspace::retrieve - genericWorkspace::list - genericWorkspace::update - genericWorkspace::delete - genericWorkspace::fieldRead - genericWorkspace::fieldWrite - crmOpportunity::create - crmOpportunity::retrieve - crmOpportunity::list - crmOpportunity::update - crmOpportunity::delete - crmOpportunity::fieldRead - crmOpportunity::fieldWrite - crmStage::create - crmStage::retrieve - crmStage::list - crmStage::update - crmStage::delete - crmStage::fieldRead - crmStage::fieldWrite - crmPipeline::create - crmPipeline::retrieve - crmPipeline::list - crmPipeline::update - crmPipeline::delete - crmPipeline::fieldRead - crmPipeline::fieldWrite - crmEngagement::create - crmEngagement::retrieve - crmEngagement::list - crmEngagement::update - crmEngagement::delete - crmEngagement::fieldRead - crmEngagement::fieldWrite - telephonyCall::create - telephonyCall::retrieve - telephonyCall::list - telephonyCall::update - telephonyCall::delete - telephonyCall::fieldRead - telephonyCall::fieldWrite - telephonyCallTranscript::create - telephonyCallTranscript::retrieve - telephonyCallTranscript::list - telephonyCallTranscript::update - telephonyCallTranscript::delete - telephonyCallTranscript::fieldRead - telephonyCallTranscript::fieldWrite - schedulingEventType::create - schedulingEventType::retrieve - schedulingEventType::list - schedulingEventType::update - schedulingEventType::delete - schedulingEventType::fieldRead - schedulingEventType::fieldWrite - schedulingSlot::create - schedulingSlot::retrieve - schedulingSlot::list - schedulingSlot::update - schedulingSlot::delete - schedulingSlot::fieldRead - schedulingSlot::fieldWrite - schedulingEvent::create - schedulingEvent::retrieve - schedulingEvent::list - schedulingEvent::update - schedulingEvent::delete - schedulingEvent::fieldRead - schedulingEvent::fieldWrite - widgetCardView::create - widgetCardView::retrieve - widgetCardView::list - widgetCardView::update - widgetCardView::delete - widgetCardView::fieldRead - widgetCardView::fieldWrite - accountingInvoice::create - accountingInvoice::retrieve - accountingInvoice::list - accountingInvoice::update - accountingInvoice::delete - accountingInvoice::fieldRead - accountingInvoice::fieldWrite - accountingInvoiceLineItem::create - accountingInvoiceLineItem::retrieve - accountingInvoiceLineItem::list - accountingInvoiceLineItem::update - accountingInvoiceLineItem::delete - accountingInvoiceLineItem::fieldRead - accountingInvoiceLineItem::fieldWrite - accountingInvoiceItem::create - accountingInvoiceItem::retrieve - accountingInvoiceItem::list - accountingInvoiceItem::update - accountingInvoiceItem::delete - accountingInvoiceItem::fieldRead - accountingInvoiceItem::fieldWrite additionalProperties: false text/plain: schema: type: object properties: operations: type: array items: type: string enum: - genericCompany::create - genericCompany::retrieve - genericCompany::list - genericCompany::update - genericCompany::delete - genericCompany::fieldRead - genericCompany::fieldWrite - genericContact::create - genericContact::retrieve - genericContact::list - genericContact::update - genericContact::delete - genericContact::fieldRead - genericContact::fieldWrite - genericUser::create - genericUser::retrieve - genericUser::list - genericUser::update - genericUser::delete - genericUser::fieldRead - genericUser::fieldWrite - genericWorkspace::create - genericWorkspace::retrieve - genericWorkspace::list - genericWorkspace::update - genericWorkspace::delete - genericWorkspace::fieldRead - genericWorkspace::fieldWrite - crmOpportunity::create - crmOpportunity::retrieve - crmOpportunity::list - crmOpportunity::update - crmOpportunity::delete - crmOpportunity::fieldRead - crmOpportunity::fieldWrite - crmStage::create - crmStage::retrieve - crmStage::list - crmStage::update - crmStage::delete - crmStage::fieldRead - crmStage::fieldWrite - crmPipeline::create - crmPipeline::retrieve - crmPipeline::list - crmPipeline::update - crmPipeline::delete - crmPipeline::fieldRead - crmPipeline::fieldWrite - crmEngagement::create - crmEngagement::retrieve - crmEngagement::list - crmEngagement::update - crmEngagement::delete - crmEngagement::fieldRead - crmEngagement::fieldWrite - telephonyCall::create - telephonyCall::retrieve - telephonyCall::list - telephonyCall::update - telephonyCall::delete - telephonyCall::fieldRead - telephonyCall::fieldWrite - telephonyCallTranscript::create - telephonyCallTranscript::retrieve - telephonyCallTranscript::list - telephonyCallTranscript::update - telephonyCallTranscript::delete - telephonyCallTranscript::fieldRead - telephonyCallTranscript::fieldWrite - schedulingEventType::create - schedulingEventType::retrieve - schedulingEventType::list - schedulingEventType::update - schedulingEventType::delete - schedulingEventType::fieldRead - schedulingEventType::fieldWrite - schedulingSlot::create - schedulingSlot::retrieve - schedulingSlot::list - schedulingSlot::update - schedulingSlot::delete - schedulingSlot::fieldRead - schedulingSlot::fieldWrite - schedulingEvent::create - schedulingEvent::retrieve - schedulingEvent::list - schedulingEvent::update - schedulingEvent::delete - schedulingEvent::fieldRead - schedulingEvent::fieldWrite - widgetCardView::create - widgetCardView::retrieve - widgetCardView::list - widgetCardView::update - widgetCardView::delete - widgetCardView::fieldRead - widgetCardView::fieldWrite - accountingInvoice::create - accountingInvoice::retrieve - accountingInvoice::list - accountingInvoice::update - accountingInvoice::delete - accountingInvoice::fieldRead - accountingInvoice::fieldWrite - accountingInvoiceLineItem::create - accountingInvoiceLineItem::retrieve - accountingInvoiceLineItem::list - accountingInvoiceLineItem::update - accountingInvoiceLineItem::delete - accountingInvoiceLineItem::fieldRead - accountingInvoiceLineItem::fieldWrite - accountingInvoiceItem::create - accountingInvoiceItem::retrieve - accountingInvoiceItem::list - accountingInvoiceItem::update - accountingInvoiceItem::delete - accountingInvoiceItem::fieldRead - accountingInvoiceItem::fieldWrite additionalProperties: false responses: '201': description: Created content: application/json: schema: allOf: - type: object properties: object: type: string default: connection - type: object properties: object: type: string enum: - connection default: connection connectorId: type: string ownerId: type: string operations: type: array items: type: string status: type: string createdAt: type: string updatedAt: type: string required: - connectorId - ownerId - operations - status - createdAt - updatedAt application/jwt: schema: allOf: - type: object properties: object: type: string default: connection - type: object properties: object: type: string enum: - connection default: connection connectorId: type: string ownerId: type: string operations: type: array items: type: string status: type: string createdAt: type: string updatedAt: type: string required: - connectorId - ownerId - operations - status - createdAt - updatedAt text/plain: schema: allOf: - type: object properties: object: type: string default: connection - type: object properties: object: type: string enum: - connection default: connection connectorId: type: string ownerId: type: string operations: type: array items: type: string status: type: string createdAt: type: string updatedAt: type: string required: - connectorId - ownerId - operations - status - createdAt - updatedAt '400': description: Bad Request 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 ````