Invitations

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 specified invitation.
GET /invitation/invitationCampaign/{invitationCampaignId}	Returns a JSN object for specified invitationCampaign.
GET /invitationCampaign	Returns all invitationCampaign objects on a business' account in array format.
GET /invitationCampaign/{invitationCampaignId}	Returns all invitation objects for specified invitationCampaign.
POST /invitationCampaign/client/{commaSeparatedStringOfClientIds}	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 /invitationCampaign	Updates an existing invitation campaign object. Can only be used to update description and expiration date.

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.

GET /invitation/{invitationId}

{
    "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-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
}

GET /invitation/invitationCampaign/{invitationCampaignId}

[{
    "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-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
}]

GET /invitationCampaign

[{
    "businessId": 43111,
    "coordinatorStaffId": null,
    "createdDate": 1539962301620,
    "createdUser": "JoeSchmo",
    "description": "Campaign sent on 10/19/2018 @ 11:18AM",
    "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":"154514","reasonId":"255109","locationId":"157670"}",
    "professionalId": 77961,
    "reasonId": null,
    "requisitionNumber": null,
    "staffId": null,
    "status": null
}]

GET /invitationCampaign/{invitationCampaignId}

{
    "businessId": 43111,
    "coordinatorStaffId": null,
    "createdDate": 1540391632592,
    "createdUser": "JoeSchmo",
    "description": "Campaign sent on 10/19/2018 @ 11:18AM",
    "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":"154514","reasonId":"255109","locationId":"157670"}",
    "professionalId": 77961,
    "reasonId": null,
    "requisitionNumber": null,
    "staffId": null,
    "status": null
}

POST /invitationCampaign/client/{commaSeparatedStringOfClientIds}

{
    "businessId": 43111,
    "coordinatorStaffId": null,
    "createdDate": 1540306834662,
    "createdUser": "JoeSchmo",
    "description": "Campaign set on 10/23/2018 @ 11:00AM",
    "email": {Email object connected to specified invitation campaign-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,
            "eventDefnId": 76691,
            "modifiedDate": null,
            "modifiedUser": null
        }],
        "eventDefnId": 76691,
        "eventType": {
            "eventCategory": null,
            "eventType": null,
            "eventTypeId": 9,
            "objectType": null
        },
        "groupIdList": null,
        "locationIdList": null,
        "modifiedDate": null,
        "modifiedUser": null,
        "newStatus": "COMPLETED",
        "objectId": 124392,
        "objectType": "INVITATION_CAMPAIGN",
        "objectUUId": null,
        "oldStatus": "*",
        "professionalIdList": null,
        "reasonIdList": null,
        "triggerHours": null
    }],
    "expireDate": 1540944000000,
    "invitationCampaignId": 124392,
    "jobRequisitionId": null,
    "jobTitle": null,
    "locationId": 81181,
    "locationName": null,
    "modifiedDate": null,
    "modifiedUser": null,
    "parameterMap": {
        "locationId": "81181",
        "reasonId": "255109", 
        "staffId: "82275"
     },
    "parameters": "{"staffId":"82275","reasonId":"255109","locationId":"81181"}",
    "professionalId": 77961,
    "reasonId": 255109,
    "requisitionNumber": null,
    "staffId": 82275,
    "status": null
}

PUT /invitationCampaign

{
    "businessId": 43111,
    "coordinatorStaffId": null,
    "createdDate": 1539956304696,
    "createdUser": "JoeSchmo",
    "description": "Campaign set on 10/19/2018 @ 9:38AM",
    "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"}",
    "professionalId": 77961,
    "reasonId": null,
    "requisitionNumber": null,
    "staffId": null,
    "status": null
}

invitationCampaign

Property Name	Type	Required	Description
businessId	integer	Yes	Provides unique numeric ID for the business to which specified invitation campaign belongs.
coordinatorStaffId	integer		Provides unique numeric ID for any coordinator staff connected to specified invitation campaign.
createdDate	integer		Displays as date specified invitation campaign was created in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
createdUser	string		Displays as username of the user who created specified invitation campaign.
description	string		Displays as description of specified invitation campaign.
email	object	Yes	Displays as email object connected to specified campaign - for more info, see Emails API page.
emailTemplateId	integer		Provides unique numeric ID of email template used for specified invitation campaign.
employmentDurationType	string		Displays as a string that can be merged to 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 specified invitation campaign is set to expire in milliseconds elapsed since January 1, 1970 00:00:00 UTC form..
invitationCampaignId	integer	Yes, on PUT calls	Provides unique numeric ID for specified invitation campaign.
jobRequisitionId	integer		Provides unique numeric requisition ID for specified job.
jobTitle	string		Displays as job title entered on business' account.
modifiedDate	integer		Displays as date 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 specified invitation campaign.
parameterMap	object		Displays parameters for call being made in object form.
parameters	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.
reasonId	integer		Provides unique numeric ID for any reason connected to specified invitation campaign.
requisitionNumber	integer		Displays as number stored on specified job requisition. Requisition numbers are used to connect candidates to appointments booked.
staffId	integer		Provides unique numeric ID for any staff connected to specified invitation campaign.
status	string		Displays as status of specified invitation campaign.

invitation

Property Name	Type	Description
businessId	integer	Provides unique numeric ID for the business to which specified invitation belongs.
clickDate	integer	Displays as date specified invitation was clicked in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
clicked	boolean	Indicates whether or not specified invitation should show as clicked.
completed	boolean	Indicates 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 as username of user who created specified invitation.
declineDate	integer	Displays as date specified invitation was declined in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
declined	boolean	Indicates whether or not specified invitation should show as declined.
email	object	Displays as email object connected to specified invitation.
invitationCampaignId	integer	Provides unique numeric ID for invitation campaign connected to specified invitation.
invitationUUId	string	Provides unique alphanumeric ID for specified invitation.
modifiedDate	integer	Displays as date specified invitation was last modified in milliseconds elapsed since January 1, 1970 00:00:00 UTC form.
modifiedUser	string	Displays as user who last modified specified invitation.
objectId	integer	Provides unique numeric ID for object connected to specified invitation.
objectType	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	Indicates whether or not specified invitation has been opened by recipient.
sent	boolean	Indicates whether or not specified invitation has successfully sent.
status	string	Displays as status of specified invitation. Has available options "PENDING", "SENT", "OPENED", "CLICKED", "COMPLETED", "DECLINED"
unsubscribed	boolean	Indicates whether or not specified invitation should show as unsubscribed.

Invitations API Endpoints

Invitations API Parameters

Invitations API Responses

Invitations Object Values

invitationCampaign

invitation