---
title: "Is there a connector for this credential?"
method: GET
path: "/v1/connectors/suggest"
tags: ["Connectors"]
---

# Is there a connector for this credential?

`GET /v1/connectors/suggest`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/connectors/suggest`
- Auth: HTTP bearer

Asked before a secret is written, so the caller can offer to connect the service properly instead of filing a key that cannot do the job. A user stored an X bearer token, a consumer key and a consumer secret and asked their agent to post daily; none of the three can post, because X needs a user-context OAuth grant. Nothing said so until the agent failed.

Matches on both a provider name and a credential word, so `api-keys/x-bearer-token` suggests the X connector and `notes/slack-migration-plan` suggests nothing — a hint that fires on every path is one people learn to scroll past.

## Query parameters

- `path` string, required

## Response `200`

The matching connector, or null.

- object
  - `preset` ConnectorPreset, required
    - `slug` string, required
    - `display_name` string, required
    - `description` string, required
    - `category` string, required
    - `provider_slug` string, nullable: `oauth_providers.slug`, or null when the connector uses a pasted API key.
    - `oauth_scopes` string[]
    - `required_scopes` string[]: Scopes without which the connector cannot do anything.
    - `binding_type` string, required
    - `base_url` string, uri, required
    - `allowed_hosts` string[]: Hosts the installed binding may reach. Always includes the base URL's host.
    - `documentation_url` string, uri
    - `tier_required` string
    - `requires_oauth` boolean, required
    - `event_sources` ConnectorEventSource[]: Events 1Claw can synthesise for this connector by polling a list endpoint through the installed binding (nanobots item 4, polling interim). Subscribe with `POST /v1/agents/{agent_id}/event-subscriptions`.
      - `event_type` string, required
      - `description` string, required
      - `path` string, required: Path (with query) relative to the binding's base URL, inside the preset's allowed paths.
      - `items_pointer` string, required: JSON pointer to the array of items in the response body; empty means the body is the array.
      - `id_pointers` string[], required: Pointers within one item whose values together identify it.
      - `min_interval_secs` integer, required

## Other responses

- `401`: Unauthenticated

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/ae109b496830?raw)