Public API
Subscription API
Subscription Schema Reference
22min
subscription schema reference objects createsubscriberpayload return type of createsubscriber field name description subscriber subscription schema reference docid 6fu5dgr5rpbwat27pcxz the information about a newly created subscriber example { "subscriber" newsubscriber! } createsubscriptionpayload return type of createsubscription field name description subscription subscription schema reference docid 6fu5dgr5rpbwat27pcxz the information about a newly created event subscription example { "subscription" eventsubscription! } updatesubscriberpayload return type of updatesubscriber field name description subscriber subscription schema reference docid 6fu5dgr5rpbwat27pcxz the information about an updated subscriber example { "subscriber" subscriber! } inputobjects createsubscriberfields input object for making new subscribers field name description name subscription schema reference docid 6fu5dgr5rpbwat27pcxz the entity subscribing to event notifications naming convention is \<provider using integration> \<affiliated brand> webhookurl subscription schema reference docid 6fu5dgr5rpbwat27pcxz an url where subscription notification events will be sent to example { "name" "example provider example brand", "webhookurl" "https //example net/subscriptions" } createsubscriptionfields input object for making new subscriptions field name description evententity subscription schema reference docid 6fu5dgr5rpbwat27pcxz a evententity enum of the entity to receive notifications about (e g for notifications each time an order event occurs, this would be order ) eventkey subscription schema reference docid 6fu5dgr5rpbwat27pcxz a eventkey enum of the particular event to notify on (e g for notifications when an order is accepted, this would be an accepted event) parententity subscription schema reference docid 6fu5dgr5rpbwat27pcxz a parententity enum indicating the owner of the entity to receive notifications about (e g the specific catering location to receive order accepted notifications for, etc ) parentid subscription schema reference docid 6fu5dgr5rpbwat27pcxz an id for the owner of the entity to receive notifications about for the menu public api the parentid value should be a caterer uuid subscriberid subscription schema reference docid 6fu5dgr5rpbwat27pcxz an id for the subscriber wanting to receive these events example { "evententity" "order", "eventkey" "accepted", "parententity" "caterer", "parentid" "ezcater caterer id", "subscriberid" "your subscriber id" } eventsubscription a subscription allows a subscriber to enable notifications for a particular event (e g when an order is accepted at a particular catering location) when a subscription is created, all event notifications will be received at the subscriber’s webhook url field name description evententity subscription schema reference docid 6fu5dgr5rpbwat27pcxz a evententity enum of the entity to receive notifications about (e g for notifications each time an order event occurs, this would be order ) eventkey subscription schema reference docid 6fu5dgr5rpbwat27pcxz a eventkey enum of the particular event to notify on (e g for notifications when an order is accepted, this would be an accepted event) parententity subscription schema reference docid 6fu5dgr5rpbwat27pcxz a parententity enum indicating the owner of the entity to receive notifications about (e g the specific catering location to receive order accepted notifications for, etc ) parentid subscription schema reference docid 6fu5dgr5rpbwat27pcxz an id for the owner of the entity to receive notifications about for the menu public api the parentid value should be a caterer uuid subscriberid subscription schema reference docid 6fu5dgr5rpbwat27pcxz an id for the subscriber wanting to receive these events example { "evententity" "order", "eventkey" "accepted", "parententity" "caterer", "parentid" "ezcater caterer id", "subscriberid" "your subscriber id" } newsubscriber this object represents a url to receive all subscription notifications one subscriber can be created per access token a subscriber can have many subscriptions field name description id subscription schema reference docid 6fu5dgr5rpbwat27pcxz the id for the subscriber name subscription schema reference docid 6fu5dgr5rpbwat27pcxz the entity subscribing to event notifications naming convention is \<provider using integration> \<affiliated brand> subscriptions subscription schema reference docid 6fu5dgr5rpbwat27pcxz active event subscriptions for the subscriber webhooksecret subscription schema reference docid 6fu5dgr5rpbwat27pcxz the token provided when posting events to the webhook to ensure the notification was sent by ezcater webhookurl subscription schema reference docid 6fu5dgr5rpbwat27pcxz an url where subscription notification events will be sent to example { "id" "your subscriber id", "name" "example provider example brand", "subscriptions" \[eventsubscription!]!, "webhooksecret" "be6efd0f8e88fec0d51364559ca9a258e70031f7f38448ea2e9705928a929a8d", "webhookurl" "https //example net/subscriptions" } subscriber this object represents a url to receive all subscription notifications one subscriber can be created per access token a subscriber can have many subscriptions field name description id subscription schema reference docid 6fu5dgr5rpbwat27pcxz the id for the subscriber name subscription schema reference docid 6fu5dgr5rpbwat27pcxz the entity subscribing to event notifications naming convention is \<provider using integration> \<affiliated brand> subscriptions subscription schema reference docid 6fu5dgr5rpbwat27pcxz active event subscriptions for the subscriber webhookurl subscription schema reference docid 6fu5dgr5rpbwat27pcxz an url where subscription notification events will be sent to example { "id" "your subscriber id", "name" "example provider example brand", "subscriptions" \[eventsubscription!]!, "webhookurl" "https //example net/subscriptions" } updatesubscriberfields input object for updating subscribers field name description name subscription schema reference docid 6fu5dgr5rpbwat27pcxz the entity subscribing to event notifications naming convention is \<provider using integration> \<affiliated brand> webhookurl subscription schema reference docid 6fu5dgr5rpbwat27pcxz an url where subscription notification events will be sent to example { "name" "example provider example brand", "webhookurl" "https //example net/subscriptions" } enums evententity the name of the entity to receive subscription notifications about applied to the evententity type as the field's return type enum name description menu the menu event entity is used to receive subscription notifications for menu events menucreationrequest the menucreationrequest event entity is used to receive subscription notifications for menu creation request events order the order event entity is used to receive subscription notifications for order events eventkey the particular event to notify on applied to the eventkey type as the field's return type as the integration functionality expands, there may be additional event subscription options as well enum name description submitted a menu entity event indicating an order has been placed by the ordering customer accepted a menu entity event indicating an order has been accepted or an order has been updated & that update is accepted by there caterer or on behalf of a caterer through a partner integration rejected a menu entity event indicating an order has been rejected by a caterer or on behalf of a caterer through a partner integration cancelled a menu entity event indicating an order has been cancelled by the ordering customer, or ezcater on behalf of the caterer uncancelled a menu entity event indicating an order has been uncancelled by the ordering customer, or ezcater on behalf of the caterer succeeded a menucreationrequest entity event indicating that a menu creation request has completed successfully succeeded with warnings a menucreationrequest entity event indicating that a menu creation request has completed successfully but with warnings that may require review failed a menucreationrequest entity event indicating a menu creation request has failed with errors that require review updated a menu entity event indicating that a menu has been changed parententity the owner of the entity to receive notifications about applied to the parententity type as the field's return type enum name description caterer the caterer is they only owner available today scalars id the id scalar type represents a unique identifier, often used to refetch an object or as key for a cache the id type appears in a json response as a string; however, it is not intended to be human readable when expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an id string the string scalar type represents textual data, represented as utf 8 character sequences the string type is most often used by graphql to represent free form human readable text uuid universally unique identifier as defined by rfc 4122