Skip to main content
Talk to salesStart

Revoke sender account delegation

Revoke another organization user’s active delegation to a sender account.

DELETE/api/sender-accounts/{sender_account_id}/delegations/{delegate_user_id}
HTTP referenceScope user session (owner/admin)Updated June 3, 2026

This page documents the canonical HTTP contract for this endpoint.

Requires a user session and the account owner or an admin. The account must support send when a nonempty capabilities list is present; managed-fleet senders also require the actor’s current allocation and mailbox access. The path accepts the delegate’s user ID or exact email; the API resolves it within the current organization. Revocation marks active matching delegation records as revoked and returns the number changed.

Revocation affects future authorization. Existing tasks may already have sender bindings persisted.

Path parameters

  • sender_account_idrequired

    string

    Sender account ID.

  • delegate_user_idrequired

    string

    User ID or exact email of a user in the current organization whose active delegation should be revoked.

Errors

StatusMeaning
401Authentication failed or a user session is required.
403Developer API keys are blocked; only the account owner or an admin user session can revoke delegation.
404Sender account or delegate user not found in the current organization.
409Sender account does not support the send scope required to manage delegation.

Docs