Page Comparison

AnchortoptopThe Invitations API is used to access and modify the invitation objects on your business' account. The Invitations API is connected to

Info

title	On this page

Table of Contents

Invitations API Endpoints AnchorinvoiceAPIinvoiceAPI

Return to Top

These are the endpoints that are available under the /invitations path, which lists all the different gift cards on your business' account.

EndpointDescriptionGET /invitation/{invitationId

Anchor

	top
	top

The Invitations API is used to access and modify the invitation objects and invitationCampaign objects on your business' account. The Invitations API is connected to the Locations, Staff, and Services APIs, as invitation campaigns are sent out for events at a particular location with a particular staff member for a particular service.

Info

title	On this page

Table of Contents

These are the endpoints that are available under the /invitations path, which lists all the different gift cards on your business' account.

Endpoint	Description
GET /invitation/{invitationUUId}	Returns a JSON object for the specified invitation.
GET /invitation/invitationCampaign/{invitationCampaignId}	Returns a JSN JSON object for the specified invitationCampaign.
GET /invitationCampaign	Returns all invitationCampaign objects on a business' account in array format.
GET /invitationCampaign/{invitationCampaignId}	Returns a all invitation objects for specified invitationCampaign.
POST /invitationCampaign/client/{commaSeparatedStringOfClientIdsclientIdList}	Sends an email invitation to specified clients. Request body/payload: Must pass an invitation campaign object in request body/payload. For these calls, you need to pass an invitation campaign object with all required fields and any fields you want to update or set filled in the body of the payload. We have an example of an invitation campaign object in the responses section below and have indicated the required fields in the object values table at the bottom of this page.
PUT POST /invitationCampaignUpdates an existing /staff/{staffIdList}	Sends an email invitation to a staff to create an appointment. Request body/payload: Must pass an invitation campaign object . Can only be used to update description and expiration date.

Parameter

Type

Endpoints to be used with

Description

pageNumber

string

GET /invitationCampaign

Works with the pageSize parameter to determine how invitations get returned following a GET invitationCampaign call. The pageNumber value represents the number of pages on which the invitations that get returned appear.

in request body/payload.

For these calls, you need to pass an invitation campaign object with all required fields and any fields you want to update or set filled in the body of the payload. We have an example of an invitation campaign object in the responses section below and have indicated the required fields in the object values table at the bottom of this page.

PUT /invitationCampaign

Updates an existing invitation campaign object. Can only be used to update description and expiration date.

Request body/payload: Must pass an invitation campaign object with all fields you want to change filled in.

Data points passed on in the request URL portion of the API call that are used to filter the data being requested.

Parameter	Type	Endpoints to be used with	Description
pageNumber	string	GET /invitationCampaign	Works with the pageSize parameter to determine how invitations get returned following a GET invitationCampaign call. The pageNumber value represents the number of pages on which the invitations that get returned appear.
pageSize	integer	GET /invitationCampaign	Works with the pageNumber parameter to determine how invitations gets returned following a GET invitationCampaign call. The pageSize value represents the number of invitations appearing on each page that gets returned.
professionalId	integer	GET /invitationCampaign	Should be set to the professionalId of person who sent the invitationCampaign to be returned.

Code BlocklanguagejstitleGET /invitation/{invitationUUId

The objects below represent the minimum viable objects to pass that are needed to send an invitations object. Check whether or not a property can be written to by looking at the Object Values table below to see if the property is writable.

{

Code Block

language	js
title	POST /invitationCampaign/client/{clientId}
linenumbers	true
collapse	true

	true

{
    "businessId": 43111,
    "description": "Campaign for Sparkles, J, Cat Grooming sent on 05/09/2023 @ 11:45AM",
    "email": {Email object for email of specified invitation campaign - for more info, see Emails API page},
    "emailTemplateId": 217246,
    "eventDefinitionList": [],
    "parameterMap": {
        "clientId": 6444669,
        "coordStaffId": 77961,
        "jobId": 57804,
        "jobRequisitionId": 62883,
        "locationId": 495584,
        "reasonId": 255109,
        "requisitionNumber": "1",
        "staffId": 77961,
    },
    "professionalId": 77961,
	"appointmentIntentId": 1234,
    "status": null
}

Code Block

language	js
title	PUT /invitationCampaign
linenumbers	true
collapse	true

{
    "businessId": 43111,
    "calendarId": null,
    "coordinatorStaffId": null,
    "createdDate": 1684245327502,
    "createdUser": "JoeSchmo",
    "description": "Campaign for Sparkles, J, Cat Grooming sent on 05/16/2023 @ 9:55AM",
    "disclaimerFormUUid": null,
    "email": null,
    "emailTemplateId": 217246,
    "employmentDurationType": null,
    "eventDefinitionList": null,
    "expireDate": "2023-05-31",
    "invitationCampaignId": 673515,
    "jobRequisitionId": null,
    "jobTitle": null,
    "locationId": null,
    "locationName": null,
    "modifiedDate": null,
    "modifiedUser": null,
    "parameterMap": null,
    "parameters": "{\"staffId\":\"77961\",\"coordStaffId\":\"77961\",\"reasonId\":\"255109\",\"locationId\":\"495584\",\"jobId\":\"57804\",\"requisitionNumber\":\"1\",\"jobRequisitionId\":\"62883\"}",
    "professionalId": 77961,
	"appointmentIntentId": 1234,
    "reasonId": null,
    "requisitionNumber": null,
    "staffId": null,
    "status": null,
    "waitListId": null
}

Code Block

language	js
title	GET /invitation/{invitationId}
linenumbers	true
collapse	true

{
    "businessId": 43111,
    "clickDate": 1540317889771,
    "clicked": true,
    "completed": true,
    "completedDate": 1540317921105,
    "createdDate": 1540317840787,
    "createdUser": "JoeSchmo",
    "declineDate": null,
    "declined": false,
    "email": {Email object for email of specified invitation - for more info, see emails API page},
    "invitationCampaignId": 123733,
    "invitationUUId": "ivtce7769a717fa480a907847b99c4574d1",
    "modifiedDate": 1540317921105,
    "modifiedUser": "WebClient",
    "objectId": 5146945,
    "objectType": "CLIENT",
    "openDate": 1540317881254,
    "opened": true,
    "sent": true,
    "status": "COMPLETED",
    "unsubscribed": false
}

Code Block

language	js
title	GET /invitation/invitationCampaign/{invitationCampaignId}
linenumbers	true
collapse	true

[{
    "businessId": 43111,
    "clickDate": 1540390475194,
    "clicked": true,
    "completed": false,
    "completedDate": null,
    "createdDate": 1540390976818,
    "createdUser": "JoeSchmo",
    "declineDate": null,
    "declined": false,
    "email": {Email object for email of specified invitation - for more info, see Emails API page},
    "invitationCampaignId": 124359,
    "invitationUUId": "ivt15dc6e1c815e416f85e9c6cf8bdc2118",
    "modifiedDate": 1540391025551,
    "modifiedUser": "WebClient",
    "objectId": 5146945,
    "objectType": "CLIENT",
    "openDate": null,
    "opened": false,
    "sent": true,
    "status": "CLICKED",
    "unsubscribed": false
}]

Code Block

language	js
title	GET /invitationCampaign
linenumbers	true
collapse	true

[{
    "businessId": 43111,
    "calendarId": null,
    "coordinatorStaffId": null,
    "createdDate": 1539962301620,
    "createdUser": "JoeSchmo",
    "description": "Campaign sent on 10/19/2018 @ 11:18AM",
    "disclaimerFormUUid": null,
    "email": null,
    "emailTemplateId": 70689,
    "employmentDurationType": null,
    "eventDefinitionList": null,
    "expireDate": null,
    "invitationCampaignId": 121587,
    "jobRequisitionId": null,
    "jobTitle": null,
    "locationId": null,
    "locationName": null,
    "modifiedDate": null,
    "modifiedUser": null,
    "parameterMap": null,
    "parameters": "{\"staffId\":\"77961\",\"coordStaffId\":\"298660\",\"reasonId\":\"434637\",\"locationId\":\"81181\",\"jobId\":\"67044\",\"clientId\":\"5360110\",\"requisitionNumber\":\"7\",\"jobRequisitionId\":\"72420\"}",
    "professionalId": 77961,
    "reasonId": null,
    "requisitionNumber": null,
    "staffId": null,
    "status": null,
    "waitlistId": null
}]

Code Block

language	js
title	GET /invitationCampaign/{invitationCampaignId}
linenumbers	true
collapse	true

[{
    "businessId": 43111,
    "coordinatorStaffId": null,
    "createdDate": 1540391632592,
    "createdUser": "JoeSchmo",
    "description": "Campaign sent on 10/19/2018 @ 11:18AM",
    "disclaimerFormUUid": null,
    "email": null,
    "emailTemplateId": 70689,
    "employmentDurationType": null,
    "eventDefinitionList": null,
    "expireDate": 1540944000000,
    "invitationCampaignId": 1243292,
    "jobRequisitionId": null,
    "jobTitle": null,
    "locationId": 81181,
    "locationName": null,
    "modifiedDate": null,
    "modifiedUser": null,
    "parameterMap: null,
    "parameters": "{\"staffId\":\"77961\",\"coordStaffId\":\"298660\",\"reasonId\":\"434637\",\"locationId\":\"81181\",\"jobId\":\"67044\",\"clientId\":\"5360110\",\"requisitionNumber\":\"7\",\"jobRequisitionId\":\"72420\"}",
    "professionalId": 77961,
    "reasonId": null,
    "requisitionNumber": null,
    "staffId": null,
    "status": null,
    "waitlistId": null
}]

Code Block

language	js
title	POST /invitationCampaign/client/{clientIdList}
linenumbers	true
collapse	true

{
    "businessId": 43111,
    "calendarId": null,
    "coordinatorStaffId": 77961,
    "createdDate": 1540306834662,
    "createdUser": "JoeSchmo",
    "description": "Campaign set on 10/23/2018 @ 11:00AM",
    "disclaimerFormUUid": null,
    "email": {Email object connected to specified invitation campaign - for more info, see Emails API page},
    "emailTemplateId": 70689,
    "employmentDurationType": null,
    "eventDefinitionList": [{
        "active": true,
        "businessId": 43111,
        "createdDate": 1540391632663,
        "description": null,
        "eventActions": [{
            "actionType": "SEND_EMAIL",
            "active": true,
            "businessId": 43111,
            "createdDate": 1540391632670,
            "createdUser": "JoeSchmo",
            "emailCategoryId": null,
            "emailTemplateId": 12937,
            "eventActionId": 76757,
            "businessIdeventDefnId": 4311176691,
     "clickDate       "modifiedDate": 1540317889771,null,
            "clickedmodifiedUser": true,null
       "completed": true, }],
        "completedDateeventDefnId": 154031792110576691,
        "createdDateeventType": 1540317840787,{
      "createdUser": "JoeSchmo",     "declineDateeventCategory": null,
    "declined": false,        "emaileventType": {Email object for email of specified invitation-see emails API page},null,
            "invitationCampaignIdeventTypeId": 1237339,
      "invitationUUId": "ivtce7769a717fa480a907847b99c4574d1",     "modifiedDateobjectType": null
1540317921105,     "modifiedUser": "WebClient",  },
  "objectId": 5146945,     "objectTypegroupIdList": "CLIENT", null,
        "openDatelocationIdList": 1540317881254null,
        "openedmodifiedDate": truenull,
        "sentmodifiedUser": truenull,
        "statusnewStatus": "COMPLETED",
        "unsubscribedobjectId": false
}

Code Block

language	js
title	GET /invitationCampaign
linenumbers	true
collapse	true

[{124392,
    "businessId": 43111,     "coordinatorStaffIdobjectType": null"INVITATION_CAMPAIGN",
        "createdDateobjectUUId": 1539962301620null,
        "createdUseroldStatus": "JoeSchmo*",
        "descriptionprofessionalIdList": "Campaign sent on 10/19/2018 @ 11:18AM",null,
        "emailreasonIdList": null,
 
  "emailTemplateId": 70689,     "employmentDurationTypetriggerHours": null,
    "eventDefinitionList": null}],
    "expireDate": null1540944000000,
    "invitationCampaignId": 121587124392,
    "jobRequisitionId": null,
    "jobTitle": null,
    "locationId": null81181,
    "locationName": null,
    "modifiedDate": null,
    "modifiedUser": null,
    "parameterMap": {
   null,     "parametersclientId": "{"staffId":"154514","reasonId":"255109","locationId":"157670"}",6444669",
        "coordStaffId": "77961",
        "jobId": "57804",
        "professionalIdjobRequisitionId": 77961,"62883",
        "reasonIdlocationId": null"81181",

   "requisitionNumber": null,
    "staffIdreasonId": null"255109", 
   "status": null }]

Code Block

language	js
title	GET /invitation/invitationCampaign/{invitationCampaignId}
linenumbers	true
collapse	true

[{     "businessIdrequisitionNumber": 43111"1",
    "clickDate": null,     "clicked"staffId: false,"82275"
    "completed": false},
    "completedDateparameters": null,
    "createdDate": 1539792767824,
    "createdUser": "JoeSchmo",
    "declineDate": null,
    "declined": false,
    "email": {Email object for email of specified invitation-see emails API page},
    "invitationCampaignId": 120697"{\"staffId\":\"77961\",\"coordStaffId\":\"77961\",\"reasonId\":\"255109\",\"locationId\":\"495584\",\"jobId\":\"57804\",\"clientId\":\"6444669\",\"requisitionNumber\":\"1\",\"jobRequisitionId\":\"62883\"}",
    "professionalId": 77961,
	"appointmentIntentId": 1234,
    "invitationUUIdreasonId": "ivt8f729ce8a71a49889959bacf620f4ec4"255109,
    "modifiedDaterequisitionNumber": 1539892787456null,
    "modifiedUserstaffId": "webhook"82275,
    "objectIdstatus": 5143212, null
}

Code Block

language	js
title	POST /invitationCampaign/staff{staffIdList}
linenumbers	true
collapse	true

{
    "objectTypebusinessId": "CLIENT"43111,
    "openDatecoordinatorStaffId": null77961,
    "openedcreatedDate": false1574350992582,
    "sentcreatedUser": true"MORGANKEARNEY",
    "statusdescription": "SENT"Campaign for Beach, Jonny Amante, Guided meditation "unsubscribed": false
}]

Code Block

language	js
title	POST /invitationCampaign/client/{commaSeparatedStringOfClientIds}
linenumbers	true
collapse	true

{sent on 11/21/2019 @ 10:40AM",
    "businessIdemail": 43111 {Email object connected to specified invitation campaign - for more info, see emails API page},
    "coordinatorStaffIdemailTemplateId": null155556,
    "createdDateemploymentDurationType": 1540306834662null,
    "createdUsereventDefinitionList": "JoeSchmo"[],
    "descriptionexpireDate": "Campaignnull,
set on 10/23/2018 @ 11:00AM""invitationCampaignId": 259369,
    "emailjobRequisitionId": null,
  {Email object connected to specified invitation campaign-see emails API page}"jobTitle": null,
    "locationId": 81181,
    "emailTemplateIdlocationName": 70689null,
    "employmentDurationTypemodifiedDate": null,
    "eventDefinitionListmodifiedUser": []null,
    "expireDateparameterMap": null,{
        "invitationCampaignIdstaffId": 123468,"81155", 
        "jobRequisitionIdcoordStaffId": null"77961",
 
  "jobTitle": null,     "locationIdreasonId": 157670"153346", 
   "locationName": null,     "modifiedDatelocationId": null, "81181"
       "modifiedUser": null},
    "parameterMapparameters": "{\"staffId: \":\"77961\",\"coordStaffId\":\"77961\", \"reasonId\": \"255109\", \"locationId\": \"157670495584\"},
    "parameters": "{"staffId":"77961","reasonId":"255109","locationId":"157670\"jobId\":\"57804\",\"clientId\":\"6444669\",\"requisitionNumber\":\"1\",\"jobRequisitionId\":\"62883\"}",
    "professionalId": 77961,
	"appointmentIntentId": 1234,
    "reasonId": 255109153346,
    "requisitionNumberrequisitionNnmber": null,
    "staffId": 7796181155,
    "status": null
}

{

Code Block

language	js
title	PUT /invitationCampaign
linenumbers	true
collapse	true

	true

{
    "businessId": 43111,
    "businessIdcalendarId": 43111null,
    "coordinatorStaffId": null,
    "createdDate": 1539956304696,
    "createdUser": "JoeSchmo",
    "description": "Campaign set on 10/19/2018 @ 9:38AM",
    "disclaimerFormUUid": null,
    "email": null,
    "emailTemplateId": 70689,
    "employmentDurationType": null,
    "eventDefinitionList": null,
    "expireDate": 1540944000000,
    "invitationCampaignId": 121455,
    "jobRequisitionId": null,
    "jobTitle": null,
    "locationId": null,
    "locationName": null,
    "modifiedDate": 1540302776156,
    "modifiedUser": "JoeSchmo",
    "parameterMap": null,
    "parameters": "{"staffId":"81651","reasonId":"153346","locationId":"157670"{\"staffId\":\"77961\",\"coordStaffId\":\"77961\",\"reasonId\":\"255109\",\"locationId\":\"495584\",\"jobId\":\"57804\",\"requisitionNumber\":\"1\",\"jobRequisitionId\":\"62883\"}",
    "professionalId": 77961,
	"appointmentIntentId": 1234,
    "reasonId": null,
    "requisitionNumber": null,
    "staffId": null,
    "status": null,
    "waitlistId": null
}

GET /invitations

invitationCampaign

businessId business clickDate clicked clicked

Property Name	Type	Required	Description
businessId	integer	Yes	Provides unique numeric ID for the business to which the specified invitation campaign belongs.
calendarId	integer	Yes		Provides unique numeric ID for the	calendar to which the specified invitation campaign belongs.
coordinatorStaffId	integer		Provides unique numeric ID for any coordinator staff connected to the specified invitation campaign.
createdDate	integer		Displays as date the specified invitation campaign was	created in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
createdUser	boolean	Flag for whether or not specified invitation should show as clicked.	completed	boolean	Flag for whether or not specified invitation should show as completed.	completedDate	integer	Displays as date specified invitation was completed in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.	createdDate	integer	Displays as date specified invitation was created in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.	createdUser	string	Displays the username of user who created specified invitation.	declineDatestring	Displays as username of the user who created the specified invitation campaign.
description	string		Displays as description of the specified invitation campaign.
disclaimerFormUUid	string		Provides unique alphanumeric ID for any disclaimer form connected to the specified invitation campaign.
email	object	Yes	Displays as email object connected to the specified invitation campaign - for more info, see Emails API page.
emailTemplateId	integer		Provides unique numeric ID of email template used for the specified invitation campaign.
employmentDurationType	string		Displays as a string that can be merged to the specified invitation with the tag REQ_DURATION_TYPE%.
eventDefinitionList	array		Displays as an array of eventDefinition objects. For more information, see Events API page.
expireDate	integer		Displays as date the specified invitation was declined campaign is set to expire in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
invitationCampaignId	declined	boolean	Flag for whether or not specified invitation should show as declined.	email	object	Displays as email object connected to specified invitation.	invitationCampaignIdinteger	Yes, on PUT calls	Provides unique numeric ID for the specified invitation campaign.
jobRequisitionId	integer		Provides unique numeric requisition ID for invitation campaign connected to specified invitationthe specified job.
invitationUUIdjobTitle	stringProvides unique alphanumeric ID for specified invitation		Displays as the job title entered on business' account.
modifiedDate	integer		Displays as date the specified invitation campaign was last modified in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
modifiedUser	string		Displays as username of the user who last modified the specified invitation campaign.
objectIdparameterMap	integer	Provides unique numeric ID for object connected to specified invitation.	objectTypeobject		Displays parameters for call being made in object form.
parameters	string		Displays as the objectType of specified invitation. Has available options "CLIENT'", "STAFF", and "APPOINTMENT".	openDate	integer	Displays as date specified invitation was opened in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.	opened	boolean	Flag for whether or not specified invitation should show as opened.	sent	boolean	Flag for whether or not specified invitation should show as sentstring representations of parameters for call being made.
professionalId	integer		Provides unique numeric ID for any staff connected to the specified invitation campaign.
reasonId	integer		Provides unique numeric ID for any reason connected to the specified invitation campaign.
requisitionNumber	integer		Displays as number stored on the specified job requisition. Requisition numbers are used to connect candidates to appointments booked.
staffId	integer		Provides unique numeric ID for any staff connected to the specified invitation campaign.
status	string		Displays as status of the specified invitation campaign.
waitlistId	integer		Provides unique numeric ID for any waitlist connected to the specified invitation . Has available options "PENDING", "CLICKED", "COMPLETED",	unsubscribed	boolean	Flag for whether or not specified invitation should show as unsubscribed.

GET /invitationCampaign

campaign.
appointmentIntentId	integer		Provides unique numeric ID for any appointment intents connected to the specified invitation campaign.

invitation

campaign Displays as date specified invitation campaign was created

Property Name	TypeRequired	Description
businessId	integer	Yes	Provides unique numeric ID for the business to which the specified invitation	belongs.	coordinatorStaffId	integer	Provides unique numeric ID for any coordinator staff connected to specified invitation campaign.
createdDate	integer	Yes	clickDate	integer	Displays as date the specified invitation was clicked in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
clicked	boolean	Indicates whether or not the specified invitation should show as clicked.
completed	boolean	Indicates whether or not the specified invitation should show as completed.
completedDate	integer	Displays as date the specified invitation was completed in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
createdUsercreatedDate	string	Yesinteger	eventDefinitionList	array	expireDate	Displays as username of date the user who created specified invitation campaign.	description	string	Displays as description of specified invitation campaign.	email	object	Displays as email object connected to specified campaign.	emailTemplateId	integer	Provides unique numeric ID of email template used for specified invitation campaign.	employmentDurationType	specified invitation was created in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
createdUser	string	Displays as username of user who created the specified invitation.
declineDate	integer	Displays as date the specified invitation campaign is set to expire was declined in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
declined	boolean	Indicates whether or not the specified invitation should show as declined.
email	object	Displays as email object connected to the specified invitation.
invitationCampaignId	integer	Provides unique numeric ID for invitation campaign connected to the specified invitation campaign.
invitationUUId	jobRequisitionId	jobTitlestring	Provides unique alphanumeric ID for the specified invitation.
modifiedDate	integer	Displays as date the specified invitation campaign was last modified in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
modifiedUser	string	Displays as username of the user who last modified the specified invitation campaign.
parameterMapobjectId	object	Displays parameters for call being made in object form.	parametersinteger	Provides unique numeric ID for object connected to the specified invitation.
objectType	string	Displays as string representations of parameters for call being made.	professionalId	integer	Provides unique numeric ID for any staff connected to specified invitation campaign.	publicVisible	boolean	Flag for whether or not specified invitation campaign is visible to the public.	reasonId	integer	Provides unique numeric ID for any reason connected to specified invitation campaign.	requisitionNumber	staffId	integer	Provides unique numeric ID for any staff connected to specified invitation campaignthe objectType of the specified invitation. Has available options "CLIENT'", "STAFF", and "APPOINTMENT".
openDate	integer	Displays as date the specified invitation was opened in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
opened	boolean	Indicates whether or not the specified invitation has been opened by recipient.
sent	boolean	Indicates whether or not the specified invitation has successfully sent.
status	string	Displays as status of specified invitation campaignthe specified invitation. Has available options "PENDING", "SENT", "OPENED", "CLICKED", "COMPLETED", "DECLINED"
unsubscribed	boolean	Indicates whether or not the specified invitation should show as unsubscribed.

Versions Compared

Old Version 29

New Version Current

Key

Invitations API Endpoints
Anchor
invoiceAPI
invoiceAPI

Invitations API Parameters

Invitations API Parameters

Invitations API

Request Body/Payloads

Invitations API Responses

Invitations Object Values

invitationCampaign

invitation