Sign in
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.

Requires the org to already have a connected mailbox; returns 422 otherwise, since the send_email tool can't send without one.

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
voice_account_cpsnumber nullable
created_atstring date-time required
updated_atstring date-time required

Changes

Changed in 1 of the 3 revisions of this API.5

  • 5a5597ebb2d65See the full diff
    • ○

      added the optional property retry_after to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property retry_after to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property retryable to the response with the 400 status

      response-optional-property-added

    • ○

      added the optional property retryable to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property voice_account_cps to the response with the 201 status

      response-optional-property-added

    This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog