# 💫 Segment Partner Destination Documentation Template

---
Gist Destination
---

## Template begins here...

[Gist](https://getgist.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners) is a marketing and support platform that helps companies attract visitors, convert leads, and support customers.

This destination is maintained by Gist. For any issues with the destination, please [reach out to their team](mailto:[e-mail]).

## Getting Started

{% include content/connection-modes.md %}

1. From your Segment UI's Destinations page click on "Add Destination".
2. Search for "Gist" within the Destinations Catalog and confirm the Source you'd like to connect to.
3. Drop in your [API Key](https://app.getgist.com/projects/_/settings/api-key) into your Segment Settings UI.

## Identify
If you haven't had a chance to review our spec, please take a look to understand what the [Identify method](https://segment.com/docs/connections/spec/identify/) does. An example call would look like:

analytics.identify('userId123', {
  email: '[e-mail]'
});

`userId` and `email` fields are **required** fields.

When you identify a new user, the contact will be created in Gist. If the contact already exists, the contact properties will be updated according to the traits provided.

See [Gist’s Contact Properties](https://docs.getgist.com/article/241-contact-properties-glossary) for more details.

Only `identify` events can *update* Contacts.

## Track
If you haven't had a chance to review our spec, please take a look to understand what the [Track method](https://segment.com/docs/connections/spec/track/) does. An example call would look like:

analytics.track('Login Button Clicked')

Segment's `track` events create Gist events and associate them with a specific Contact.

The name of the `track` event appears as a Custom Event in Gist and is able to trigger workflows, segment users, and view analytics.

An `email` field is **required** to create a Contact with a `track` event.

---