Invitation Lists

4 endpoints

GET /{account_slug}/{event_slug}/invitation_lists

list invitation lists

Returns a paginated list of all invitation lists for the specified event.

Requires authentication

Path parameters

Name	Description
`account_slug` string Required	The unique slug identifier for your Tito account
`event_slug` string Required	The unique slug identifier for the event

Query parameters

Name	Description
`page` integer	Page number for pagination (default: 1)

Response fields

Field	Description
`invitation_lists` array

Error responses

401 – unauthorized - no bearer token provided or token is invalid

Example request

curl \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.staging.pro.tito.io/{account_slug}/{event_slug}/invitation_lists

POST /{account_slug}/{event_slug}/invitation_lists

create invitation list

Creates a new invitation list for the specified event.

Requires authentication

Path parameters

Name	Description
`account_slug` string Required	The unique slug identifier for your Tito account
`event_slug` string Required	The unique slug identifier for the event

Request body

Field	Type	Required	Description
`name`	string	Yes	Name of the invitation list
`default_ticket_type_id`	integer	Yes	ID of the default ticket type for invitations in this list
`distribution_option`	string	No	How invitations are distributed (default: first_come_first_served)
`expires_at`	string	No	When invitations in this list expire (optional)

Response fields

Field	Description
`invitation_list`

Error responses

422 – unprocessable entity - validation errors
401 – unauthorized - no bearer token provided or token is invalid

Example request

curl \
  -X POST \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"VIP List","default_ticket_type_id":789,"distribution_option":"first_come_first_served","expires_at":"2026-12-31T23:59:59Z"}' \
  https://api.staging.pro.tito.io/{account_slug}/{event_slug}/invitation_lists

GET /{account_slug}/{event_slug}/invitation_lists/{id}

show invitation list

Returns detailed information about a specific invitation list.

Requires authentication

Path parameters

Name	Description
`account_slug` string Required	The unique slug identifier for your Tito account
`event_slug` string Required	The unique slug identifier for the event
`id` string Required	The unique identifier for the invitation list

Response fields

Field	Description
`invitation_list`

Error responses

404 – not found - invitation list does not exist

Example request

curl \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.staging.pro.tito.io/{account_slug}/{event_slug}/invitation_lists/123

PATCH /{account_slug}/{event_slug}/invitation_lists/{id}

update invitation list

Updates an existing invitation list. Note: distribution_option, expires_at, and auto_delivering cannot be changed after invitations have been sent.

Requires authentication

Path parameters

Name	Description
`account_slug` string Required	The unique slug identifier for your Tito account
`event_slug` string Required	The unique slug identifier for the event
`id` string Required	The unique identifier for the invitation list

Request body

Field	Type	Required	Description
`name`	string	No	Name of the invitation list
`default_ticket_type_id`	integer	No	ID of the default ticket type
`distribution_option`	string	No	How invitations are distributed
`expires_at`	string	No	When invitations in this list expire

Response fields

Field	Description
`invitation_list`

Error responses

404 – not found - invitation list does not exist

Example request

curl \
  -X PATCH \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Updated VIP List","default_ticket_type_id":789,"distribution_option":"string","expires_at":"string"}' \
  https://api.staging.pro.tito.io/{account_slug}/{event_slug}/invitation_lists/123

← Previous Events Next → Invitations