Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-304917042.1 MB
integrations

Connect the Email integration (born active; presence marker for the send_email tool)

Create a born-active presence connection so the send_email tool materializes and becomes attachable. There is no credential to collect — the Nylas API key is platform-level and the sending mailbox is connected via the separate email OAuth flow. The tool sync is dispatched post-commit.

post/v1/integrations/connections/email

Request body

nicknamestring

Response

Successful Response

idstring uuid required
organization_idstring uuid required
integration_key'slack' | 'custom_mcp' | 'notion' | 'google_drive' | 'calcom' | 'twilio' | 'email' required

Stable identifier for each supported integration.

The string value must match the vendor's per-provider identifier (for Nango: provider_config_key). Persisted on integration_connections.integration_key and integration_connection_tools.integration_key.

Adding a new integration: append a member here, add an IntegrationSpec to INTEGRATIONS, register the provider in the vendor cloud via src/integrations/bootstrap.py (Step 3).

nickname_slugstring required
nicknamestring required
vendorstring required
vendor_connection_idstring nullable required
statusstring required
tools_statusstring required
tools_synced_atstring date-time nullable required
status_reasonstring nullable required
connected_atstring date-time nullable required
last_refreshed_atstring date-time nullable required
last_used_atstring date-time nullable required
metadataobject required
created_atstring date-time required
updated_atstring date-time required