Skip to main content
POST
/
v1
/
connectors
Create a new connector
curl --request POST \
  --url https://api.wellapp.ai/v1/connectors \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "connector",
  "attributes": {
    "slug": "salesforce",
    "name": "Salesforce",
    "description": "Connects to Salesforce CRM for sync.",
    "category": "api",
    "direction": "import",
    "tags": [
      "crm",
      "cloud",
      "sync"
    ],
    "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"
  },
  "relationships": {
    "published_by": {
      "data": {
        "type": "workspace",
        "id": "airbyte"
      }
    },
    "logo": {
      "data": {
        "type": "media",
        "id": "media3"
      }
    }
  },
  "included": [
    {
      "type": "workspace",
      "id": "airbyte",
      "attributes": {
        "name": "Airbyte",
        "description": "Open-source data integration platform",
        "website": "https://airbyte.com",
        "external_workspace_id": "airbyte_workspace_001"
      }
    },
    {
      "type": "media",
      "id": "media3",
      "attributes": {
        "file_name": "salesforce_logo.png",
        "content_type": "image/png",
        "file_size": 15420,
        "media_type": "logo",
        "upload_url": "https://storage.well.com/media/salesforce_logo.png"
      }
    }
  ]
}
'
{ "data": { "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", "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

Body

application/json
​
data
object
required

Response

Connector created successfully

​
data
object