> ## 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. # Retrieve a connection **Session Token**
You can also retrieve a connection using a session token by making a GET request to `/v1/s/connection`. This requires setting both the `x-api-key` and `x-session-token` headers. ## OpenAPI ````yaml get /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}: get: tags: - Connection summary: Retrieve 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 responses: '200': description: OK 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 '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 ````