List connectors

Returns every connector instance configured in your organization.

Scope: connectors:read

Query parameters

Example request

curl https://dashboard.getmacha.com/api/v1/connectors \
  -H "Authorization: Bearer $MACHA_API_KEY"

Example response

{
  "data": [
    {
      "id": "connector_64f1c0ef2ec711ef6dc1dcf",
      "type": "zendesk",
      "name": "Production Zendesk",
      "status": "connected",
      "is_active": true,
      "created_at": "2026-06-01T00:00:00.000Z",
      "updated_at": "2026-06-20T12:00:00.000Z"
    },
    {
      "id": "connector_64f1c0ef2ec711ef6dc1dc0",
      "type": "slack",
      "name": "Customer Success Slack",
      "status": "connected",
      "is_active": true,
      "created_at": "2026-06-05T00:00:00.000Z",
      "updated_at": "2026-06-05T00:00:00.000Z"
    }
  ],
  "meta": { "request_id": "req_...", "next_cursor": null }
}

Watch for auth_failed connectors

If a connector returns "status": "auth_failed", every agent that uses tools from it has been auto-deactivated. The fix is to reconnect the integration in the dashboard. The API does not expose a reconnect endpoint in v1.

Errors