Get Connectors by id

Get connector by ID

curl --request GET \
  --url https://api.wellapp.ai/v1/connectors/{id} \
  --header 'Authorization: <authorization>'

{
  "type": "connector",
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "attributes": {
    "slug": "salesforce",
    "name": "Salesforce",
    "description": "Connects to Salesforce CRM for sync.",
    "category": "api",
    "direction": "import",
    "tags": [
      "crm",
      "cloud",
      "sync"
    ],
    "status": "active",
    "version": "2.1.0",
    "data_quality": {
      "imported_fields": [
        "invoice",
        "company",
        "people"
      ],
      "last_synced": "2025-06-20T09:00:00Z"
    },
    "redirect_url": "https://app.well.com/connectors/salesforce/success",
    "state": "active",
    "created_at": "2025-10-07T14:30:00.000Z",
    "updated_at": "2025-10-07T14:30:00.000Z"
  },
  "relationships": {
    "published_by": {
      "data": {
        "type": "workspace",
        "id": "airbyte"
      }
    },
    "logo": {
      "data": {
        "type": "media",
        "id": "550e8400-e29b-41d4-a716-446655440010"
      }
    }
  },
  "included": [
    {
      "type": "workspace",
      "id": "airbyte",
      "attributes": {
        "name": "Airbyte",
        "description": "Open-source data integration platform",
        "website": "https://airbyte.com"
      }
    },
    {
      "type": "media",
      "id": "550e8400-e29b-41d4-a716-446655440010",
      "attributes": {
        "file_name": "salesforce_logo.png",
        "content_type": "image/png",
        "file_size": 12345
      }
    }
  ]
}

GET

connectors

{id}

Get connector by ID

curl --request GET \
  --url https://api.wellapp.ai/v1/connectors/{id} \
  --header 'Authorization: <authorization>'

{
  "type": "connector",
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "attributes": {
    "slug": "salesforce",
    "name": "Salesforce",
    "description": "Connects to Salesforce CRM for sync.",
    "category": "api",
    "direction": "import",
    "tags": [
      "crm",
      "cloud",
      "sync"
    ],
    "status": "active",
    "version": "2.1.0",
    "data_quality": {
      "imported_fields": [
        "invoice",
        "company",
        "people"
      ],
      "last_synced": "2025-06-20T09:00:00Z"
    },
    "redirect_url": "https://app.well.com/connectors/salesforce/success",
    "state": "active",
    "created_at": "2025-10-07T14:30:00.000Z",
    "updated_at": "2025-10-07T14:30:00.000Z"
  },
  "relationships": {
    "published_by": {
      "data": {
        "type": "workspace",
        "id": "airbyte"
      }
    },
    "logo": {
      "data": {
        "type": "media",
        "id": "550e8400-e29b-41d4-a716-446655440010"
      }
    }
  },
  "included": [
    {
      "type": "workspace",
      "id": "airbyte",
      "attributes": {
        "name": "Airbyte",
        "description": "Open-source data integration platform",
        "website": "https://airbyte.com"
      }
    },
    {
      "type": "media",
      "id": "550e8400-e29b-41d4-a716-446655440010",
      "attributes": {
        "file_name": "salesforce_logo.png",
        "content_type": "image/png",
        "file_size": 12345
      }
    }
  ]
}

Headers

Authorization

string

required

Bearer token for authentication

Path Parameters

string<uuid>

required

The unique identifier of the connector to retrieve

Query Parameters

include

string

Include related resources in the response. Multiple values can be comma-separated.

Response

Connector retrieved successfully

data

object

required

Show child attributes

data.data

object

Show child attributes

data.data.type

string

Allowed value: "connector"

data.data.id

string<uuid>

UUID of the created connector

Example:

"550e8400-e29b-41d4-a716-446655440000"

data.data.attributes

object

Show child attributes

data.data.attributes.slug

string

Connector slug used in URLs (system generated if not provided)

Maximum string length: 255

Example:

"salesforce"

data.data.attributes.name

string

Connector name

Maximum string length: 255

Example:

"Salesforce"

data.data.attributes.description

string

Description of the connector

Maximum string length: 1000

Example:

"Connects to Salesforce CRM for sync."

data.data.attributes.category

enum<string>

Integration category. See all available categories for complete list.

Available options:

database,

...

Example:

"api"

data.data.attributes.direction

enum<string>

Data flow direction capability

Available options:

import,

export,

both

Example:

"import"

data.data.attributes.tags

string[]

Grouping/search tags

Example:

["crm", "cloud", "sync"]

data.data.attributes.data_quality

object

Show child attributes

data.data.attributes.data_quality.imported_fields

enum<string>[]

Category connector. See all available categories for complete list.

Available options:

invoice,

company,

people

Example:

["invoice", "company", "people"]

data.data.attributes.data_quality.last_synced

string<date-time>

Timestamp of last sync

Example:

"2025-06-20T09:00:00Z"

data.data.attributes.redirect_url

string<uri>

URL to redirect customers after onboarding flow

Example:

"https://app.well.com/connectors/salesforce/success"

data.data.attributes.state

string

State included in the redirect URL

Example:

"active"

data.data.attributes.status

enum<string>

Lifecycle status (system managed)

Available options:

active,

beta,

deprecated

Example:

"active"

data.data.attributes.created_at

string<date-time>

Creation timestamp

Example:

"2025-10-07T14:30:00.000Z"

data.data.attributes.updated_at

string<date-time>

Last update timestamp

Example:

"2025-10-07T14:30:00.000Z"

data.data.relationships

object

Show child attributes

data.data.relationships.published_by

object

Show child attributes

data.data.relationships.published_by.data

object

Show child attributes

data.data.relationships.published_by.data.type

string

Allowed value: "workspace"

data.data.relationships.published_by.data.id

string<uuid>

UUID of the workspace that published this connector

Example:

"550e8400-e29b-41d4-a716-446655440001"

data.data.relationships.logo

object

Show child attributes

data.data.relationships.logo.data

object

Show child attributes

data.data.relationships.logo.data.type

string

Allowed value: "media"

data.data.relationships.logo.data.id

string<uuid>

UUID of the logo media

Example:

"550e8400-e29b-41d4-a716-446655440010"

data.data.included

object

Object containing included resources referenced in relationships, organized by resource type. These are the actual created/linked resources with real UUIDs.

Show child attributes

data.data.included.published_by

object

Workspaces associated with this company

Show child attributes

data.data.included.published_by.data

object[]

Show child attributes

data.data.included.published_by.data.type

string

Allowed value: "workspace"

data.data.included.published_by.data.id

string<uuid>

UUID of the workspace

data.data.included.published_by.data.attributes

object

Show child attributes

data.data.included.published_by.data.attributes.name

string

required

Workspace name

Required string length: 1 - 255

data.data.included.published_by.data.attributes.description

string

Workspace description

Maximum string length: 1000

data.data.included.published_by.data.attributes.avatar_color

string

Avatar color in hexadecimal format (e.g., #FF5733)

data.data.included.published_by.data.attributes.external_workspace_id

string

External workspace identifier

Required string length: 1 - 255

data.data.included.media

object

Media files associated with this company

Show child attributes

data.data.included.media.data

object[]

Show child attributes

data.data.included.media.data.type

string

Allowed value: "media"

data.data.included.media.data.id

string<uuid>

UUID of the media

data.data.included.media.data.attributes

object

Show child attributes

data.data.included.media.data.attributes.media_type

enum<string>

Available options:

avatar,

logo,

banner

data.data.included.media.data.attributes.url

string<uri>

URL to the media file

data.data.included.media.data.attributes.is_primary

boolean

Whether this is the primary media

data.data.included.media.data.attributes.processed_at

string<date-time>

Timestamp when media processing completed

data.data.included.media.data.attributes.uploaded_at

string<date-time>

Create Connectors Get Connectors

⌘I

Main Resources

Atomic Resources

System

Headers

Path Parameters

Query Parameters

Response