# 💫 Segment Partner Destination Documentation Template

> Hi Partners 👋🏼
>
> Welcome to Segment - glad to have you onboard! This doc serves as a guideline for your team to create best-in-class documentation alongside your amazing product.
>
> At Segment, we believe that documentation is crucial in delivering the best experience for our mutual customers so we want to think with the following mindset:
>
>+ Be succinct and simple in your writing. Reduce text bloat where possible.
>+ Avoid 1st person language as it’s confusing for customers if they don’t know who wrote the docs (Segment or the Partner).
>+ Use the active voice - instead of "The destination will do this." write something like "The destination does this."
>+ Where pre-reading is required, hyperlink to other more generic parts of Segment’s (or your) documentation.
>
>+ Provide actionable code samples for each API method.
>
>+ If you would like to include screenshots, send the original image to us via [e-mail] with naming corresponding to where you've included it within the Markdown below. We prefer PNG images within 400px - 1200px. If you'd like to submit a GIF, keep under 15MB. Generally you should be able to write these out as text, so only use them when there's something really hard to explain.
>
> The below template intends to provide a standardized structure. Please **make a copy** of this template for editing and submit to the Segment team as a new note on [HackMD.io](https://hackmd.io/). You can view a sample doc as reference here: https://segment.com/docs/connections/destinations/catalog/clearbrain/.
>
> If a section does not apply to your integration, feel free to remove. Please don’t create separate sections unless absolutely necessary. In most cases, creating a H3 (###) sub-heading under an existing section is the best option!
>
> If you have any questions in the meantime, please reach out to our team at [e-mail].

---
title: [integration_name] Destination
---

## Template begins here...

> Include a 1-2 sentence introduction to your company and the value it provides to customers - updating the name and hyperlink. Please leave the utm string unchanged.

[Mailmodo](https://www.mailmodo.com/) is a powerful email marketing tool focused on bringing the interactive experience via AMP framework to emails. It allows businesses to create emails with web page-like interactivity right inside the user inbox, thereby increasing engagement and conversions multi-fold.

> Update your company name and support email address.

This destination is maintained by Mailmodo. For any issues with the destination, [contact the Mailmodo Support team](mailto:[e-mail]).

> Update your company name (x2) and support email address.

## Getting Started

> Do not remove this line. It will auto-populate the following information for your integration:

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

> Include clear, succinct steps including hyperlinks to where customers can locate their API Key in your app. If there is an expected delay for a customer to see data flow into your integration, please make that explicit.

1. From the Destinations catalog page in the Segment App, click **Add Destination**.
2. Search for "Mailmodo" in the Destinations Catalog, and select the "Mailmodo" destination.
3. Choose which Source should send data to the "Mailmodo" destination.
4. Go to the [Mailmodo Dashboard](https://manage.mailmodo.com/app/dashboard), navigate to **Settings > API Keys**, then create a new API Key and copy the same.
5. Enter the "API Key" in the "Mailmodo" destination settings in Segment.

> For each of the following call types (Page, Screen, Identify, Track, Group), update:
> 1. Code snippet with relevant code sample including required traits or properties.
> 2. Your integration name.
> 3. What the corresponding call looks like within your platform (eg. Segment `page` call might be a `pageview` on your platform).
> 4. It can be helpful to describe *where* data will appear (ie. Will `identify` calls appear within a Users dashboard as well as the Real-time dashboard of your platform?)
> 5. Any other important information for customer to note when sending through the events.

## Supported methods

Mailmodo supports the following methods, as specified in the [Segment Spec](/docs/connections/spec).

### Identify

If you aren’t familiar with the Segment Spec, take a look at the [Identify method documentation](/docs/connections/spec/identify) to learn about what it does.

analytics.identify('userId12345', {
  firstName: 'Bob',
  lastName: 'Dole',
  email: '[e-mail]',
  company: 'Initech',
  employees: 234
});

Every time you call identify with an email address included, we will:
1. First ask Mailmodo if the email exists.
2. If the email doesn’t exist, then we will add the user as a Contact to the Mailmodo database and match user properties with the Segment `traits` sent in identify call payload.
3. If the email exists, then we will update the user properties for the Contact against the Segment `traits` sent in identify call payload.

All the [special traits](https://segment.com/docs/connections/spec/identify#traits) recognized by Segment will be translated and matched with the Mailmodo user properties for a Contact. These fields will be automatically created or mapped for a Contact in Mailmodo and will be available for personalization and advance segmentation.

==Please note==
==1. The email field is required. Identify calls without an email is dropped.==
==2. If different email addresses are sent against same user id in identify call, then they are treated as two different contacts in Mailmodo.==

### Track
If you aren’t familiar with the Segment Spec, take a look at the [Track method documentation](/docs/connections/spec/track) to learn about what it does. An example call would look like:

analytics.track('Product Viewed', {
  product_id: '507f1f77bcf86cd799439011',
  name: 'Monopoly: 3rd Edition',
  price: 18.99,
  url: 'https://www.example.com/product/path',
  image_url: 'https://www.example.com/product/path.jpg'
});

Segment sends `Track` calls to Mailmodo as a Custom Event. When you call track, we’ll send the event to Mailmodo with the event name and all properties that you specified.

==Be sure you send an Identify call for any user who will trigger Track calls. If Mailmodo receives a Track call for an unknown userId, the call is dropped.==

---

> Congratulations! 🎉 You’ve finished the documentation for your Segment integration. If there’s any additional information or nuance which did not fit in the above template and that you want to share with our mutual customers, feel free to include these as a separate section for us to review. If not, you may now submit this doc to our team via your designated Slack Channel and we’ll respond with updates when we publish it and your integration!