Create Connectors

post/v1/connectors

Create a new connector record with integration details, configuration, and various relationships including published by workspace and media assets.

Requires a bearer token: Authorization: Bearer <token>.

Request

cURL
curl -X POST https://api.wellapp.ai/v1/connectors \
  -H "Authorization: Bearer $WELL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "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"
      }
    }
  ]
}'
Request body
{
  "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"
      }
    }
  ]
}

Responses

201 — Connector created successfully

{
  "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"
      },
      "relationships": {
        "connector_filters": {
          "data": [
            {
              "type": "ConnectorFilter",
              "id": "00000000-0000-4000-8000-000000000001"
            }
          ]
        },
        "provider_connector": {
          "data": {
            "type": "ProviderConnector",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        }
      }
    },
    {
      "type": "media",
      "id": "550e8400-e29b-41d4-a716-446655440010",
      "attributes": {
        "file_name": "salesforce_logo.png",
        "content_type": "image/png",
        "file_size": 12345
      },
      "relationships": {
        "connector_filters": {
          "data": [
            {
              "type": "ConnectorFilter",
              "id": "00000000-0000-4000-8000-000000000001"
            }
          ]
        },
        "provider_connector": {
          "data": {
            "type": "ProviderConnector",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        }
      }
    }
  ]
}

400 — Bad request - validation error

{
  "code": "BAD_REQUEST",
  "status": 400,
  "title": "Bad Request",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

401 — Unauthorized - invalid API key

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}