List connector combinations

get/v1/connector-combinations

Returns the derived set of <source>-to-<destination> connector combinations (source → Well → destination) computed over the live connector universe by the shared registry derivation. Read-only; no side effects. By default only live combinations are returned. Pass `connector` to restrict the result to combinations where that connector is either the source or the target leg.

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

Query parameters

Name	Type	Required	Description
includeComingSoon	string	No	When `true`, combinations whose status is `coming_soon` are included alongside `live` ones. When omitted or `false`, only `live` combinations are returned. Accepted as the literal strings "true"/"false" and coerced server-side.e.g. true
connector	string	No	Connector slug used to filter combinations to those where this connector is the source or target leg. Slugs may contain hyphens (e.g. `big-query`).e.g. mercury

Request

cURL

curl -X GET https://api.wellapp.ai/v1/connector-combinations \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — The list of connector combinations as JSON:API resources, with a count in `meta`.

{
  "data": [
    {
      "type": "connector-combination",
      "id": "mercury-to-quickbooks",
      "attributes": {
        "slug": "mercury-to-quickbooks",
        "source": {
          "slug": "mercury",
          "name": "Mercury",
          "service_id": "mercury",
          "category_id": "banking",
          "status": "live",
          "directions": [
            "source"
          ]
        },
        "target": {
          "slug": "quickbooks",
          "name": "QuickBooks",
          "service_id": "quickbooks",
          "category_id": "accounting",
          "status": "live",
          "directions": [
            "destination"
          ]
        },
        "deliverable": true,
        "status": "live"
      }
    }
  ],
  "meta": {
    "count": 1
  }
}

400 — Validation failed (strict query: unknown key, bad includeComingSoon, or empty connector).

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

401 — Missing or invalid bearer token.

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