Skip to main content
POST
Transfer My Ticket
Offers one of the person’s own tickets to someone else. The recipient gets an email with a link to accept it. Until they accept, the ticket stays the person’s, and the offer can be cancelled.
Personal agents only. Needs a Personal Agent Protocol Session signed in with poppy:write. Without it: 403 with WWW-Authenticate: DPoP error="sign_in_required" or error="insufficient_scope", scope="poppy:write".
This is the same transfer the person can make from their ticket page, with the same rules, limits and emails. Confirm the recipient with the person before calling it.

Idempotency

Pass an Idempotency-Key header to make retries safe. A second offer for the same ticket is refused with transfer_already_pending anyway.

Path Parameters

string
required
From tickets[].ticket_id on List My Tickets.

Request Body

string
required
The recipient’s first name.
string
required
The recipient’s last name.
string
required
Where the claim link goes. The recipient accepts with this address.
string
An optional note for the recipient, up to 500 characters.

Response

201 Created
string
The ticket offered.
string
The recipient’s name.
string
The recipient’s email.
string
When the offer expires if nobody accepts it (ISO 8601).

Errors