---
title: Vendors
slug: docs/-j_A-vendors
createdAt: 2026-07-08T06:20:45.612Z
---

The **Vendors** endpoint sends a Vendor out of your event. Its endpoint is served at `/updates/api/{endpoint-uuid}/vendors`.

## How it works

The template is the shape of the payload you want out. Each key is yours to name; the merge tag on the right supplies the value for each Vendor at send time. Every field here is plain text, so every tag stays quoted.

`active` and `deleted` use the `<<TAG|true:true,false:false>>` form. They render as the strings `"true"` and `"false"`.

## Sample mapping

:::BlockQuote
\{
&#x20;   "event\_id": "\<\<EVENT\_ID>>",
&#x20;   "event\_name": "\<\<EVENT\_NAME>>",
&#x20;   "resource\_id": "\<\<RESOURCE\_ID>>",
&#x20;   "organisation\_uid": "\<\<ORGANISATION\_UID>>",
&#x20;   "name": "\<\<NAME>>",
&#x20;   "description": "\<\<DESCRIPTION>>",
&#x20;   "active": "\<\<ACTIVE|true\:true,false\:false>>",
&#x20;   "deleted": "\<\<DELETED|true\:true,false\:false>>",
&#x20;   "updated\_at": "\<\<UPDATED\_AT>>",
&#x20;   "created\_at": "\<\<CREATED\_AT>>"
}
:::

## Sample output

One rendered Vendor from the array the endpoint returns:

:::BlockQuote
\{
&#x20; "event\_id": "your-instance/event/3365",
&#x20; "event\_name": "Platform Summit 2026",
&#x20; "resource\_id": "your-instance/vendor/895",
&#x20; "organisation\_uid": "a1s2d3f4g5h6j7k8",
&#x20; "name": "Acme Corp",
&#x20; "description": "Enterprise hardware and support.",
&#x20; "active": "true",
&#x20; "deleted": "false",
&#x20; "updated\_at": "2026-05-26T08:07:07.000000Z",
&#x20; "created\_at": "2026-04-10T09:00:18.000000Z"
}
:::

## Field reference

| Key               | Merge tag               | Emits                                     |
| ----------------- | ----------------------- | ----------------------------------------- |
| event\_id         | \<\<EVENT\_ID>>         | Text. The event's resource ID.            |
| event\_name       | \<\<EVENT\_NAME>>       | Text. The event's name.                   |
| resource\_id      | \<\<RESOURCE\_ID>>      | Text. The Vendor's resource ID.           |
| organisation\_uid | \<\<ORGANISATION\_UID>> | Text. Your own identifier for the Vendor. |
| name              | \<\<NAME>>              | Text. The Vendor name.                    |
| description       | \<\<DESCRIPTION>>       | Text. The Vendor description.             |
| active            | \<\<ACTIVE\|...>>       | Text "true" or "false".                   |
| deleted           | \<\<DELETED\|...>>      | Text "true" or "false".                   |
| updated\_at       | \<\<UPDATED\_AT>>       | Text. ISO 8601 timestamp.                 |
| created\_at       | \<\<CREATED\_AT>>       | Text. ISO 8601 timestamp.                 |

