> ## Documentation Index
> Fetch the complete documentation index at: https://developers.momogood.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> Install and configure the Tatango integration in your SFMC account

Setup happens entirely inside your Salesforce Marketing Cloud and Tatango accounts.

## Step 1: Create an installed package

In SFMC, click your profile icon in the top right and select **Setup**, then go to **Apps → Installed Packages** and click **New**. Name the package something recognizable, such as `Tatango Send Message Activity`.

## Step 2: Add an API Integration component

Open the package and click **Add Component**. Select **API Integration**, then the **Server-to-Server** integration type.

<Frame>
  <img src="https://mintcdn.com/momogood/Dro8ZZqtqv-L8tBN/images/sfmc/api-integration-component.png?fit=max&auto=format&n=Dro8ZZqtqv-L8tBN&q=85&s=f72c6d7dd05c66e4bd92dea957a07c39" alt="The Add Component wizard with API Integration selected" width="1653" height="1006" data-path="images/sfmc/api-integration-component.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/momogood/Dro8ZZqtqv-L8tBN/images/sfmc/server-to-server.png?fit=max&auto=format&n=Dro8ZZqtqv-L8tBN&q=85&s=bffb8a91d3aa219628d27f351248ef2a" alt="The integration type step with Server-to-Server selected" width="640" height="367" data-path="images/sfmc/server-to-server.png" />
</Frame>

Grant the component exactly these scopes:

| Category             | Scopes                                                         |
| -------------------- | -------------------------------------------------------------- |
| Journeys             | Read, Write, Execute, Activate/Stop/Pause/Resume/Send/Schedule |
| Audiences            | Read, Write                                                    |
| List and Subscribers | Read, Write                                                    |
| Data Extensions      | Read, Write                                                    |

<Frame>
  <img src="https://mintcdn.com/momogood/Dro8ZZqtqv-L8tBN/images/sfmc/scopes.png?fit=max&auto=format&n=Dro8ZZqtqv-L8tBN&q=85&s=e6d63dc3aa326a7bb53e93bbe30fec8d" alt="The scope selection screen with the required scopes checked" width="639" height="925" data-path="images/sfmc/scopes.png" />
</Frame>

After saving, the component summary displays three values you will enter during [initial configuration](#step-6-complete-the-initial-configuration):

* **Client Id**
* **Client Secret**
* **Authentication Base URI**

Store the client secret somewhere safe. SFMC only reveals it here.

<Frame caption="Where the Client Id, Client Secret, and Authentication Base URI live">
  <img src="https://mintcdn.com/momogood/Dro8ZZqtqv-L8tBN/images/sfmc/package-credentials.png?fit=max&auto=format&n=Dro8ZZqtqv-L8tBN&q=85&s=90fe364162b13567f5ce04baaf71066c" alt="The API Integration component summary beside the Salesforce Configuration form, with the Client Id, Client Secret, and Authentication Base URI highlighted" width="1516" height="765" data-path="images/sfmc/package-credentials.png" />
</Frame>

## Step 3: Add the Journey Builder activity

In the same package, click **Add Component** again and select **Journey Builder Activity**. Set:

* **Category**: Messages
* **Endpoint URL**: `https://app.tatango.com/api/v3/`

<Frame>
  <img src="https://mintcdn.com/momogood/Dro8ZZqtqv-L8tBN/images/sfmc/jb-activity-component.png?fit=max&auto=format&n=Dro8ZZqtqv-L8tBN&q=85&s=95c3c462c643126d7bf910aa2c3da5c5" alt="The Journey Builder Activity component properties with the category and endpoint URL filled in" width="640" height="528" data-path="images/sfmc/jb-activity-component.png" />
</Frame>

The **Tatango Transactional Message** activity now appears in Journey Builder's activity palette under Messages.

## Step 4: Import the Tatango data extensions

The integration tracks message, reply, and subscriber data in three data extensions. Install them from the deployment package:

<a href="/downloads/tatango-data-extensions-v1.json" download="tatango-data-extensions-v1.json">
  <Card title="Tatango Data Extensions package" icon="download" horizontal>
    Download the deployment JSON, then import it in SFMC.
  </Card>
</a>

In SFMC, go to **Platform → Package Manager → Deployment** and start a new install. Upload the JSON in the Package Upload step, and leave Package Customization empty; the package needs no namespacing or customization fields. The Item Validation step lists `tatango_messages`, `tatango_replies`, and `tatango_subscribers`, each with the action **Create a new item**.

<Frame>
  <img src="https://mintcdn.com/momogood/Dro8ZZqtqv-L8tBN/images/sfmc/package-manager-deployment.png?fit=max&auto=format&n=Dro8ZZqtqv-L8tBN&q=85&s=efbcbc4aecd8629fa441ec7839fd939f" alt="The Package Manager install screen with the Tatango Data Extensions package uploaded and the three data extensions listed as Ready" width="1882" height="856" data-path="images/sfmc/package-manager-deployment.png" />
</Frame>

Click **Deploy**. This creates the three data extensions in Contact Builder; their fields are documented on the [data extensions](/messaging/sfmc/data-extensions) page.

## Step 5: Create a Tatango API key

Go to the [API keys page](https://app.tatango.com/api_keys) in the Tatango app (**My Account → API**) and click **Create API Key**.

<Tip>
  Any API key works, but we recommend creating a dedicated key with a label that identifies its purpose (for example, `SFMC`) so you can always tell which key the integration relies on.
</Tip>

<Warning>
  Disabling the API key used by the integration stops all message sends from your SFMC journeys.
</Warning>

## Step 6: Complete the initial configuration

Open Journey Builder, drag the **Tatango Transactional Message** activity onto any journey canvas, and open it. On first use, you'll see a message that your account is not configured for Salesforce, with a link to the configuration page.

<Frame>
  <img src="https://mintcdn.com/momogood/Dro8ZZqtqv-L8tBN/images/sfmc/not-configured-prompt.png?fit=max&auto=format&n=Dro8ZZqtqv-L8tBN&q=85&s=497beecb5f52dacf767cca485dc35fed" alt="The activity modal showing that the account is not configured for Salesforce, with a link to the configuration page" width="600" height="213" data-path="images/sfmc/not-configured-prompt.png" />
</Frame>

Follow the link (or go directly to [app.tatango.com/api/v3/sfmc/initial\_config](https://app.tatango.com/api/v3/sfmc/initial_config)) and enter:

| Field                   | Value                                                                                    |
| ----------------------- | ---------------------------------------------------------------------------------------- |
| Tatango API Key         | The API key from [step 5](#step-5-create-a-tatango-api-key)                              |
| Client ID               | From the API Integration component in [step 2](#step-2-add-an-api-integration-component) |
| Client Secret           | From the API Integration component in [step 2](#step-2-add-an-api-integration-component) |
| Authentication Base URI | From the API Integration component in [step 2](#step-2-add-an-api-integration-component) |

Click **Save Configuration**. Saving verifies the credentials against your SFMC account, and if a field is rejected the form indicates which one to correct.

Reload the activity in Journey Builder. Configuration is complete, and every user in your SFMC account can now use the activity. Next, [send your first message](/messaging/sfmc/sending-messages).

## Troubleshooting

<AccordionGroup>
  <Accordion title="The activity says your account is not configured for Salesforce">
    This is the first-use state: complete the [initial configuration](#step-6-complete-the-initial-configuration), then reload the activity.
  </Accordion>

  <Accordion title="A credential is rejected when you save the configuration">
    The form checks each value against your SFMC account and flags the field to fix. Re-copy the flagged value from the API Integration component summary ([step 2](#step-2-add-an-api-integration-component)), and make sure the Tatango API key is correct and enabled.
  </Accordion>

  <Accordion title="Journey validation recommends adding a message activity">
    Expected: Journey Builder doesn't recognize custom activities as messaging activities, so it shows a "Missing Message Activity" recommendation. It's safe to ignore and doesn't block activation.
  </Accordion>
</AccordionGroup>
