Configure Connectors API
The Connectors API from Configure — 23 operation(s) for connectors.
The Connectors API from Configure — 23 operation(s) for connectors.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/configure-dev:configure-dev-connectors-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Configure Dev Connectors API
version: 2026-07-12
description: 'Operations tagged Connectors across 2 of this provider''s published API definitions: configure-dev-openapi-original.yaml, configure-dev-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
security:
- ApiKeyAuth: []
tags:
- name: Connectors
paths:
/v1/connectors:
get:
tags:
- Connectors
summary: List connector status
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
responses:
'200':
description: Available connectors.
content:
application/json:
schema:
type: object
properties:
connectors:
type: array
items:
type: object
additionalProperties: true
operationId: getV1Connectors
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/{connector}/connect:
post:
tags:
- Connectors
summary: Start connector OAuth
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
- $ref: '#/components/parameters/ConnectorPath'
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
callbackUrl:
type: string
format: uri
returnUrl:
type: string
format: uri
forceNew:
type: boolean
responses:
'200':
description: OAuth URL or existing connection.
operationId: postV1ConnectorsByConnectorConnect
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/{connector}/confirm:
post:
tags:
- Connectors
summary: Confirm connector OAuth
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
- $ref: '#/components/parameters/ConnectorPath'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- connectionRequestId
properties:
connectionRequestId:
type: string
responses:
'200':
description: Connection result.
operationId: postV1ConnectorsByConnectorConfirm
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/{connector}/sync:
post:
tags:
- Connectors
summary: Sync one connector
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
- $ref: '#/components/parameters/ConnectorPath'
responses:
'200':
description: Sync result.
operationId: postV1ConnectorsByConnectorSync
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/{connector}:
delete:
tags:
- Connectors
summary: Disconnect one connector
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
- $ref: '#/components/parameters/ConnectorPath'
responses:
'200':
description: Disconnect result.
operationId: deleteV1ConnectorsByConnector
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/disconnect-all:
post:
tags:
- Connectors
summary: Disconnect all connectors and reset profile files
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
responses:
'200':
description: Disconnect result.
operationId: postV1ConnectorsDisconnectAll
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/sync:
post:
tags:
- Connectors
summary: Sync selected connectors
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SyncRequest'
responses:
'200':
description: Sync result.
operationId: postV1ConnectorsSync
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/gmail/messages/search:
post:
tags:
- Connectors
summary: Search Gmail
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes. Omit account to search all connected Gmail accounts; results then include accounts_searched and partial when some accounts fail.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GmailSearchRequest'
responses:
'200':
description: Email search results.
operationId: postV1ConnectorsGmailMessagesSearch
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/outlook/messages/search:
post:
tags:
- Connectors
summary: Search Outlook
description: Search one or every permitted connected Outlook account. Requires X-API-Key plus an agent-scoped Bearer token from Configure.link().
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EmailAccountSearchRequest'
responses:
'200':
description: Outlook search results with account provenance.
operationId: postV1ConnectorsOutlookMessagesSearch
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/email/messages/search:
post:
tags:
- Connectors
summary: Search hosted email providers
description: Search every permitted Gmail and Outlook account by default. Partial responses report accounts_searched and partial=true.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/HostedEmailSearchRequest'
responses:
'200':
description: Provider-neutral email search results with provider and account provenance.
operationId: postV1ConnectorsEmailMessagesSearch
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/calendar/events/query:
post:
tags:
- Connectors
summary: Read calendar events
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CalendarRequest'
responses:
'200':
description: Calendar results.
operationId: postV1ConnectorsCalendarEventsQuery
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/drive/files/search:
post:
tags:
- Connectors
summary: Search Drive files
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SearchRequest'
responses:
'200':
description: File search results.
operationId: postV1ConnectorsDriveFilesSearch
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/notion/pages/search:
post:
tags:
- Connectors
summary: Search Notion
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SearchRequest'
responses:
'200':
description: Notion search results.
operationId: postV1ConnectorsNotionPagesSearch
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/sheets/spreadsheets/search:
post:
tags:
- Connectors
summary: Search Google Sheets
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SearchRequest'
responses:
'200':
description: Spreadsheet search results.
operationId: postV1ConnectorsSheetsSpreadsheetsSearch
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/sheets/values/get:
post:
tags:
- Connectors
summary: Read Google Sheets values
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SheetValuesGetRequest'
responses:
'200':
description: Spreadsheet values.
operationId: postV1ConnectorsSheetsValuesGet
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/calendar/events:
post:
tags:
- Connectors
summary: Create calendar event
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateEventRequest'
responses:
'200':
description: Event creation result.
operationId: postV1ConnectorsCalendarEvents
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/gmail/messages/send:
post:
tags:
- Connectors
summary: Send email
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SendEmailRequest'
responses:
'200':
description: Send result.
content:
application/json:
schema:
$ref: '#/components/schemas/SendEmailResponse'
operationId: postV1ConnectorsGmailMessagesSend
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/outlook/messages/send:
post:
tags:
- Connectors
summary: Send Outlook email
description: Send from a selected or default permitted Outlook account. Requires X-API-Key plus an agent-scoped Bearer token from Configure.link().
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SendEmailRequest'
responses:
'200':
description: Send result.
content:
application/json:
schema:
$ref: '#/components/schemas/SendEmailResponse'
operationId: postV1ConnectorsOutlookMessagesSend
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/email/messages/send:
post:
tags:
- Connectors
summary: Send hosted email
description: Send from a permitted Gmail or Outlook account. Provider ambiguity fails closed with email_account_selection_required.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/HostedSendEmailRequest'
responses:
'200':
description: Send result with provider and account provenance.
content:
application/json:
schema:
$ref: '#/components/schemas/SendEmailResponse'
operationId: postV1ConnectorsEmailMessagesSend
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/sheets/values/update:
post:
tags:
- Connectors
summary: Update Google Sheets values
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SheetValuesMutationRequest'
responses:
'200':
description: Values update result.
operationId: postV1ConnectorsSheetsValuesUpdate
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/sheets/values/append:
post:
tags:
- Connectors
summary: Append Google Sheets values
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SheetValuesMutationRequest'
responses:
'200':
description: Values append result.
operationId: postV1ConnectorsSheetsValuesAppend
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/sheets/spreadsheets:
post:
tags:
- Connectors
summary: Create Google spreadsheet
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateSpreadsheetRequest'
responses:
'200':
description: Spreadsheet creation result.
operationId: postV1ConnectorsSheetsSpreadsheets
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/connectors/sheets/sheets:
post:
tags:
- Connectors
summary: Add Google Sheets tab
description: Requires X-API-Key plus an agent-scoped Bearer token from Configure.link(). X-User-Id is not accepted for connector routes.
security:
- ApiKeyAuth: []
BearerAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AddSheetRequest'
responses:
'200':
description: Sheet tab creation result.
operationId: postV1ConnectorsSheetsSheets
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
components:
parameters:
AgentHeader:
name: X-Agent
in: header
required: false
schema:
$ref: '#/components/schemas/AgentName'
description: Required when the API key's developer account owns more than one active agent.
ConnectorPath:
name: connector
in: path
required: true
schema:
$ref: '#/components/schemas/ConnectorName'
schemas:
SyncRequest:
type: object
additionalProperties: false
properties:
connectors:
type: array
items:
$ref: '#/components/schemas/ConnectorName'
HostedSendEmailRequest:
type: object
additionalProperties: false
required:
- to
- subject
- body
properties:
to:
type: string
format: email
subject:
type: string
minLength: 1
maxLength: 500
body:
type: string
minLength: 1
maxLength: 50000
provider:
type: string
enum:
- gmail
- outlook
account:
type: string
minLength: 3
maxLength: 200
SearchRequest:
type: object
additionalProperties: false
required:
- query
properties:
query:
type: string
minLength: 1
max_results:
type: integer
default: 10
minimum: 1
maximum: 50
SendEmailRequest:
type: object
additionalProperties: false
required:
- to
- subject
- body
properties:
to:
type: string
format: email
subject:
type: string
minLength: 1
maxLength: 500
body:
type: string
minLength: 1
maxLength: 50000
account:
type: string
minLength: 3
maxLength: 200
description: Connected Gmail account ID or email to send from. Omitted, the user's default Gmail account sends.
CreateEventRequest:
type: object
additionalProperties: false
required:
- title
- start_time
- end_time
properties:
title:
type: string
minLength: 1
maxLength: 500
start_time:
type: string
end_time:
type: string
description:
type: string
maxLength: 5000
location:
type: string
maxLength: 500
CreateSpreadsheetRequest:
type: object
additionalProperties: false
required:
- title
properties:
title:
type: string
minLength: 1
maxLength: 255
SheetValuesMutationRequest:
type: object
additionalProperties: false
required:
- spreadsheet_id
- range
- values
properties:
spreadsheet_id:
type: string
minLength: 1
maxLength: 255
range:
type: string
minLength: 1
maxLength: 500
values:
type: array
minItems: 1
maxItems: 500
items:
type: array
maxItems: 200
items: {}
value_input_option:
type: string
enum:
- USER_ENTERED
- RAW
default: USER_ENTERED
CalendarRequest:
type: object
additionalProperties: false
properties:
range:
type: string
enum:
- today
- tomorrow
- week
- month
default: week
EmailAccountSearchRequest:
type: object
additionalProperties: false
required:
- query
properties:
query:
type: string
minLength: 1
max_results:
type: integer
default: 10
minimum: 1
maximum: 50
account:
type: string
minLength: 3
maxLength: 200
description: Connected account ID or email. Omitted, all permitted accounts for the endpoint provider are searched.
SheetValuesGetRequest:
type: object
additionalProperties: false
required:
- spreadsheet_id
- ranges
properties:
spreadsheet_id:
type: string
minLength: 1
maxLength: 255
ranges:
type: array
minItems: 1
maxItems: 10
items:
type: string
minLength: 1
maxLength: 500
AddSheetRequest:
type: object
additionalProperties: false
required:
- spreadsheet_id
- title
properties:
spreadsheet_id:
type: string
minLength: 1
maxLength: 255
title:
type: string
minLength: 1
maxLength: 100
row_count:
type: integer
minimum: 1
maximum: 10000
column_count:
type: integer
minimum: 1
maximum: 1000
SendEmailResponse:
type: object
additionalProperties: false
required:
- sent
- email
- message
properties:
sent:
type: boolean
description: True only when Gmail returned a provider message id. False with delivery_status=unconfirmed when the provider completed the request without an id.
retryable:
type: boolean
description: False when delivery is unconfirmed because retrying could send a duplicate email.
email:
type: object
additionalProperties: true
required:
- to
- subject
- body_preview
- delivery_status
properties:
to:
type: string
format: email
subject:
type: string
body_preview:
type: string
delivery_status:
type: string
enum:
- accepted
- unconfirmed
description: Accepted means Gmail returned a provider message id. Unconfirmed means the provider completed the request without an id; do not retry automatically.
provider_message_id:
type: string
description: Gmail message id returned by the provider. Present when delivery_status is accepted.
from_account:
type: object
additionalProperties: false
properties:
id:
type: string
email:
type: string
format: email
gmail_data:
description: Raw Gmail/connector response data retained for diagnostics.
message:
type: string
HostedEmailSearchRequest:
type: object
additionalProperties: false
required:
- query
properties:
query:
type: string
minLength: 1
max_results:
type: integer
default: 10
minimum: 1
maximum: 50
provider:
type: string
enum:
- gmail
- outlook
account:
type: string
minLength: 3
maxLength: 200
ConnectorName:
type: string
enum:
- gmail
- outlook
- calendar
- drive
- notion
- sheets
GmailSearchRequest:
type: object
additionalProperties: false
required:
- query
properties:
query:
type: string
minLength: 1
max_results:
type: integer
default: 10
minimum: 1
maximum: 50
account:
type: string
minLength: 3
maxLength: 200
description: Connected Gmail account ID or email. Omitted, all connected Gmail accounts are searched.
AgentName:
type: string
minLength: 2
maxLength: 63
pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$
example: your-agent
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Configure API key. Use sk_ on servers. pk_ is browser-safe but restricted.
SecretApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Server-side Configure secret key, prefix sk_.
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: Agent-scoped Configure token from hosted Configure.link().
ExternalUserId:
type: apiKey
in: header
name: X-User-Id
description: Stable external user ID for unlinked developer-scoped profiles. Requires sk_.
x-refined-from:
- configure-dev-openapi-original.yaml
- configure-dev-openapi.yml