Request a new provider connector

post/v1/providers/request

Records community demand for a provider not yet in the catalog. Side effects: searches GitHub for an existing open `[New Connector Request] <providerName>` issue; if found, increments the `Community Demand` counter and adds a `+1` comment; otherwise creates a new labelled issue from the request template. Returns the issue URL. Reachable at both `/v1/providers/request` and `/v1/provider/request`.

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

Request

cURL

curl -X POST https://api.wellapp.ai/v1/providers/request \
  -H "Authorization: Bearer $WELL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "providerName": "Ramp",
  "parentProviderName": "Revolut",
  "providerId": "ramp",
  "domain": "ramp.com",
  "url": "https://business.ramp.com/login",
  "timestamp": "2026-06-06T14:32:00.000Z"
}'

Request body

{
  "providerName": "Ramp",
  "parentProviderName": "Revolut",
  "providerId": "ramp",
  "domain": "ramp.com",
  "url": "https://business.ramp.com/login",
  "timestamp": "2026-06-06T14:32:00.000Z"
}

Responses

200 — The provider request was processed: a new issue was created or an existing one had its demand incremented.

{
  "success": true,
  "issueUrl": "https://github.com/WellApp-ai/platform/issues/4821",
  "message": "Provider request processed successfully"
}

400 — Validation failed: a required field missing/empty, `url` not a valid URL, `timestamp` not ISO 8601, or an unknown key.

{
  "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"
  }
}