AGagentmail-to
inboxes > webhooks

Get Webhook

Changed on

CLI:

agentmail inboxes webhooks get --inbox-id <inbox_id> --webhook-id <webhook_id>
get/v0/inboxes/{inbox_id}/webhooks/{webhook_id}

Request

  • Base URL
    https://api.agentmail.to
  • URL
    https://api.agentmail.to/v0/inboxes/{inbox_id}/webhooks/{webhook_id}
  • Auth
    HTTP bearer

Path parameters

inbox_idstring required

The ID of the inbox.

webhook_idstring required

ID of webhook.

Response

Response with status 200

webhook_idstring required

ID of webhook.

urlstring required

URL of webhook endpoint.

event_typesEventsEventType[]

Event types for which to send events.

pod_idsstring[]

Pods for which to send events.

inbox_idsstring[]

Inboxes for which to send events.

pod_idstring

ID of the pod the webhook belongs to: the pod it was created in, or the pod of the inbox it belongs to. Absent for an organization webhook and on some inbox webhooks. This is not the list of pods it receives events for; see pod_ids.

inbox_idstring

ID of the inbox the webhook belongs to, if it was created for an inbox. This is not the list of inboxes it receives events for; see inbox_ids.

secretstring required

Secret for webhook signature verification.

enabledboolean required

Whether the webhook is enabled. It becomes false when you disable it, and also when deliveries to the URL have failed for 5 days, in which case AgentMail sends no notification. Re-enable it with update and enabled set to true.

updated_atstring date-time required

Time at which webhook was last updated.

created_atstring date-time required

Time at which webhook was created.

client_idstring

Client ID of webhook.

Changes

  • 3f5c7830c952Revision changes
    • warning

      added the new calendar.event.created enum value to the / response property for the response status

    • warning

      added the new calendar.event.deleted enum value to the / response property for the response status

    • warning

      added the new calendar.event.ending enum value to the / response property for the response status

    • warning

      added the new calendar.event.responded enum value to the / response property for the response status

    • warning

      added the new calendar.event.starting enum value to the / response property for the response status

    • warning

      added the new calendar.event.updated enum value to the / response property for the response status

    • warning

      added the new message.opened enum value to the / response property for the response status

    • warning

      added the new message.security.completed enum value to the / response property for the response status

    • warning

      added the new message.security.override enum value to the / response property for the response status

    • warning

      added the new message.security.review enum value to the / response property for the response status

    • info

      the endpoint scheme security Bearer was added to the API

    • info

      the endpoint scheme security BearerAuth was removed from the API

    • info

      api tag inboxes > webhooks added

    • info

      api tag InboxesWebhooks removed

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 394ddcdd9c29Revision changes
    • info

      endpoint added