Invite Status BETA
Description #
Once a Smart Invite has been created you may need to retrieve the current state of it, usually in response to a notification from Cronofy.
Example Request #
GET /v1/smart_invites?recipient_email=cronofy@example.com&smart_invite_id=your-unique-identifier-for-invite HTTP/1.1
Host: api.cronofy.com
Authorization: Bearer {API_KEY}
Example Response #
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{
"recipient": {
"email": "cronofy@example.com",
"status": "declined",
"comment": "example comment",
"proposal": {
"start": {
"time": "2021-01-29T23:00:00+02:00",
"tzid": "Europe/Paris"
},
"end": {
"time": "2021-01-29T23:00:00+02:00",
"tzid": "Europe/Paris"
}
}
},
"replies": [
{
"email": "person1@example.com",
"status": "accepted"
},
{
"email": "person2@example.com",
"status": "declined",
"comment": "example comment",
"proposal": {
"start": {
"time": "2021-01-29T23:00:00+02:00",
"tzid": "Europe/Paris"
},
"end": {
"time": "2021-01-29T23:00:00+02:00",
"tzid": "Europe/Paris"
}
}
}
],
"smart_invite_id": "your-unique-identifier-for-invite",
"callback_url": "https://example.yourapp.com/cronofy/smart_invite/notifications",
"event": {
"summary": "Board meeting",
"description": "Discuss plans for the next quarter.",
"start": {
"time": "2021-01-31T09:30:00Z",
"tzid": "Europe/London"
},
"end": {
"time": "2021-01-31T10:00:00Z",
"tzid": "Europe/London"
},
"location": {
"description": "Board room"
}
}
}
Request parameters #
API_KEY required #
The client_secret
of the client creating the event.
smart_invite_id required #
An identifier for the event within your application. Is used along with the recipient.email to uniquely identify the Smart Invite.
recipient_email required #
The email address you are going to send the Smart Invite to.
Response parameters #
recipient.email #
The email address of the recipient for the Smart Invite.
recipient.status #
The current status of the recipient. Can be one of:
pending
have not received any response from the recipientaccepted
the recipient has accepted the invitationtentative
the recipient has tentatively accepted the invitationdeclined
the recipient has declined the invitation
recipient.comment #
Any comments provided along with the reply.
recipient.proposal #
Details of the counter proposal received as a reply
recipient.proposal.start #
The proposed start for the event an object with two attributes, time
and tzid
:
{
"time": "2021-01-28T23:00:00+02:00",
"tzid": "Europe/Paris"
}
The time
attribute is the Time
or Date
by which the event ends. This will be provided with an offset matching that of the corresponding tzid
.
The tzid
attribute specifies a String
representing a known time zone identifier from the IANA Time Zone Database.
Common examples are:
Etc/UTC
Europe/Paris
America/Chicago
recipient.proposal.end #
The proposed end for the event an object with two attributes, time
and tzid
:
{
"time": "2021-01-28T23:00:00+02:00",
"tzid": "Europe/Paris"
}
The time
attribute is the Time
or Date
by which the event ends. This will be provided with an offset matching that of the corresponding tzid
.
The tzid
attribute specifies a String
representing a known time zone identifier from the IANA Time Zone Database.
Common examples are:
Etc/UTC
Europe/Paris
America/Chicago
replies #
An array of all the replies received for the invitation.
Note These will include all replies not just the email address of the invited user. This is useful in cases of invitation forwarding, email addresss aliases or sending to distribution lists
reply.email #
The email address of the reply for the Smart Invite.
reply.status #
The current status of the reply. Can be one of:
pending
have not received any response from the replyaccepted
the reply has accepted the invitationtentative
the reply has tentatively accepted the invitationdeclined
the reply has declined the invitation
reply.comment #
Any comments provided along with the reply.
reply.proposal #
Details of the counter proposal received as a reply
reply.proposal.start #
The proposed start for the event an object with two attributes, time
and tzid
:
{
"time": "2021-01-28T23:00:00+02:00",
"tzid": "Europe/Paris"
}
The time
attribute is the Time
or Date
by which the event ends. This will be provided with an offset matching that of the corresponding tzid
.
The tzid
attribute specifies a String
representing a known time zone identifier from the IANA Time Zone Database.
Common examples are:
Etc/UTC
Europe/Paris
America/Chicago
reply.proposal.end #
The proposed end for the event an object with two attributes, time
and tzid
:
{
"time": "2021-01-28T23:00:00+02:00",
"tzid": "Europe/Paris"
}
The time
attribute is the Time
or Date
by which the event ends. This will be provided with an offset matching that of the corresponding tzid
.
The tzid
attribute specifies a String
representing a known time zone identifier from the IANA Time Zone Database.
Common examples are:
Etc/UTC
Europe/Paris
America/Chicago
smart_invite_id #
The identifier for the event within your application.
callback_url #
The URL within your application that Cronofy will send notifications to about user interactions with the Smart Invite.
event #
The details of the event.