DRdroidrun
Mailboxes

Connect a Gmail inbox

Changed on

Links the caller’s Gmail account. Replaying the same Idempotency-Key returns the same mailbox. When Gmail is already active, redirectUrl is null and the mailbox is usable immediately.

post/mailboxes/connections

Request

  • Base URL
    https://api.mobilerun.ai
  • URL
    https://api.mobilerun.ai/mailboxes/connections
  • Auth
    HTTP bearer

Headers

idempotency-keystring

Idempotency-Key: 1-255 printable ASCII characters. Same key with a different request body is a 422 idempotency_key_reused. A retryable in-flight duplicate is a 409 with Retry-After and x-should-retry: true; a terminal duplicate is a 409 with x-should-retry: false. A replay returns the current resource state with Idempotent-Replayed: true.

Example:b3f6a9f0-6f1a-4e9a-9e7a-9c9b6b6a5a3f

Request body

provider'gmail' required
labelstring
bindingHashstring

sha256 hex of the browser-held connect binding secret.

Response

Gmail mailbox link

connectionIdstring uuid required
mailboxIdstring uuid required
redirectUrlstring nullable required
status'pending' | 'active' | 'expired' | 'removed' required
addressstring nullable required

Changes

  • 559a12449213Revision changes
    • warning

      added the new integration_forbidden enum value to the //// response property for the response status

    • warning

      added the new integration_forbidden enum value to the //// response property for the response status

    • warning

      added the new integration_forbidden enum value to the //// response property for the response status

    • warning

      added the new integration_forbidden enum value to the //// response property for the response status

    • warning

      added the new integration_forbidden enum value to the response property for the response status

    • warning

      added the new integration_forbidden enum value to the response property for the response status

    • warning

      added the new integration_forbidden enum value to the response property for the response status

    • warning

      added the new provider_error enum value to the //// response property for the response status

    • warning

      added the new provider_error enum value to the //// response property for the response status

    • warning

      added the new provider_error enum value to the //// response property for the response status

    • warning

      added the new provider_error enum value to the //// response property for the response status

    • warning

      added the new provider_error enum value to the response property for the response status

    • warning

      added the new provider_error enum value to the response property for the response status

    • warning

      added the new provider_error enum value to the response property for the response status

  • 4ad548c528a8Revision changes
    • info

      endpoint added