# Tickets

The tickets webhook is for ticket shops and other existing event ticketing systems to connect attendee ticket information to *<mark style="color:purple;">talque</mark>*.  Tickets can provider users access to the talque digital platform, as well as specific talks, webinars, etc. depending on the ticket category.

Tickets can be uploaded through the webhook one or more at a time, along with an optional purchase order for those tickets.  The purchase order upload is not currently the complete data for the upload, but just to track the provenance of the tickets and who purchased them.

## Add ticket(s) and purchase order

<mark style="color:green;">`POST`</mark> `https://talque.com/webhook/org/:orgId/ticket`

#### Path Parameters

| Name                                    | Type   | Description                 |
| --------------------------------------- | ------ | --------------------------- |
| orgId<mark style="color:red;">\*</mark> | string | The talque ID of your event |

#### Request Body

| Name                                      | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ----------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| tickets<mark style="color:red;">\*</mark> | array  | <p>Array of ticket objects with properties:</p><p></p><p><code>extTicketId</code>: <em>(required)</em> Your internal identifier for the ticket</p><p></p><p><code>email</code>: For personalized tickets, the e-mail address of the ticket holder</p><p></p><p><code>firstName</code>: First name of the ticket holder; must only be provided if a personal e-mail is provided</p><p></p><p><code>lastName</code>: See <code>firstName</code></p><p></p><p><code>phoneNumber</code>: Ticket holder phone number in international E. 164 format (<code>+\<country code>\<phone number></code>)</p><p></p><p><code>phoneNumberType</code>: Either <code>"MOBILE"</code> or <code>"FIXED"</code>, if known</p><p> </p><p><code>companyName</code>: Ticket holder company, if any</p><p></p><p><code>jobTitle</code>: Ticket holder job title, if any</p><p></p><p><code>extUserId</code>: External ticketing provider's user ID for the ticket holder, if any</p><p></p><p><code>tickets</code>: An array of identifiers of the type of ticket (e.g. "day pass", "full event", etc.); this is an event-specific identifier that must be coordinated with talque; may be zero or more</p><p></p><p><code>eventIds</code>: Array of talque session IDs for sessions to which the ticket grants access</p><p></p><p><code>extEventIds</code>: Array of your internal identifiers for session add-ons to tickets.  This can be passed if the talque IDs are not known by the system.</p><p></p><p><code>vendorIds</code>: Array of talque vendor IDs for companies/exhibitors of which the ticket holder is a representative.</p><p></p><p><code>extVendorIds</code>:  If the ticket holder is a representative of a company or exhibitor, this is an array of strings providing the internal identifiers of those companies, in case the talque IDs are not known by the system.</p> |
| purchaseOrder                             | object | <p>Optional purchase order details associated with the ticket or tickets' purchase.  This property may be omitted entirely if not relevant.  It has the following properties:</p><p></p><p><code>extPurchaseId</code>: <em>(required)</em> For ticketing providers, your internal identifier for the purchase order</p><p></p><p><code>email</code>: The e-mail address of the ticket purchaser</p><p></p><p><code>firstName</code>: First name of the ticket purchaser</p><p></p><p><code>lastName</code>: See <code>firstName</code></p><p> </p><p><code>companyName</code>: Ticket purchaser company, if any</p><p></p><p><code>jobTitle</code>: Ticket purchaser job title, if any</p><p></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="403: Forbidden Missing or incorrect authorization headers" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="404: Not Found Missing or incorrect orgId" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://talque.gitbook.io/public/webhooks/tickets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.