Subscriptions

Retrieve event subscriptions for the authenticated user

Return the subscriptions visible to the authenticated user: their own and the entity's global ones. status is 1 for active and -1 for disabled. The list can be narrowed with the id, event and host query parameters.

get/v1/subscriptions

Request

  • Base URL: https://api.getaccept.com
  • URL: https://api.getaccept.com/v1/subscriptions
  • Auth: HTTP bearer

Query parameters

idstring

Return only the subscription with this id.

event'document.approved' | 'document.viewed' | 'document.hardbounced' | 'document.commented' | 'document.opened' | 'document.created' | 'document.partially_signed' | 'document.forwarded' | 'document.sent' | 'document.rejected' | 'document.downloaded' | 'document.printed' | 'comment.created' | 'document.expired' | 'document.signed' | 'document.reviewed' | 'document.recalled' | 'comment.reply_created' | 'comment.resolved' | 'document.lost' | 'document.page_tracked' | 'document.partially_rejected'

Event a webhook subscription can listen to.

Return only the subscriptions for this event.

hoststring

Return only the subscriptions whose host label is exactly this value.

Response

The request succeeded.

idstring required

Id of the subscription.

subscription_idstring required

Id of the subscription, repeated for the legacy clients.

statusnumber required

Whether the subscription is active: 1 when active and -1 once it has been disabled.

event'document.approved' | 'document.viewed' | 'document.hardbounced' | 'document.commented' | 'document.opened' | 'document.created' | 'document.partially_signed' | 'document.forwarded' | 'document.sent' | 'document.rejected' | 'document.downloaded' | 'document.printed' | 'comment.created' | 'document.expired' | 'document.signed' | 'document.reviewed' | 'document.recalled' | 'comment.reply_created' | 'comment.resolved' | 'document.lost' | 'document.page_tracked' | 'document.partially_rejected' required

Event a webhook subscription can listen to.

hoststring nullable required

Label for filtering subscriptions with the host query parameter, derived from the domain of target_url when it was not given. Events are always posted to target_url.

target_urlstring required

URL the event is posted to.

payloadstring nullable required

Extra data posted with every event, empty when none was given.

globalboolean required

Whether the subscription catches the events of every user in the entity.

notification_emailstring nullable required

Email address alerted when the delivery fails, empty when the sender is alerted instead.

created_atstring required

When the subscription was created, as yyyy-MM-dd HH:mm:ss without a time zone offset.

Changes

No recorded changes to this operation across all 1 revision of this API.