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
⌘I