> For the complete documentation index, see [llms.txt](https://docs.mediarithmics.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mediarithmics.io/audience-and-activation/activate-your-audiences/set-up-a-connection-to-a-partner-platform/connect-your-partner-account.md).

# Connect your partner account

Connect your organisation's account on a partner platform, and keep that connection authenticated so your feeds can send to it.

## Your goal

Give the platform an authenticated connection to your account on a partner platform, so that presets and feeds can be built on it.

A **destination** is your organisation's authenticated connection to a partner platform - Google DV360, Meta, The Trade Desk. It stores the credentials needed to send data to that partner, and is the foundation for one or more [presets](https://docs.mediarithmics.io/audience-and-activation/activate-your-audiences/set-up-a-connection-to-a-partner-platform/configure-what-you-send-to-the-partner.md#your-goal).

Every feed on the platform is ultimately linked to a destination through a preset, so a destination must exist and be authenticated before any feed can be created against that partner.

A destination is scoped to **one connector and one partner account**. Which connectors exist, and what each one can receive, is documented in the [Connectors](https://docs.mediarithmics.io/connectors/) section - that section is authoritative for the connector ecosystem, and this one does not duplicate it.

These things are decided at this level and nowhere else:

* **Which partner account** the data goes to.
* **How the platform authenticates** to it.

Everything else - what is sent, which identifiers, how it is formatted - belongs to the preset.

{% hint style="info" %}
To share a segment with another mediarithmics datamart rather than a partner platform, use the [mediarithmics Shared Segment](https://docs.mediarithmics.io/connectors/destinations/mediarithmics-shared-segment.md) connector.
{% endhint %}

## Expected outcome

A destination with the status **Authenticated**, listed in the **Overview** tab of **Navigator > Feeds**, on which presets can be created.

## Prerequisites

* A connector for the partner platform. If the partner you need has none, see [Connectors on request](https://docs.mediarithmics.io/connectors/connectors-on-request.md).
* What the connector's authentication method asks for. See [Authentication methods](#authentication-methods).

## Create the destination

{% stepper %}
{% step %}

#### Start from the Overview tab

Go to **Navigator > Feeds**, **Overview** tab, and click **New destination**.
{% endstep %}

{% step %}

#### Choose the connector

Find the connector you want and select it.
{% endstep %}

{% step %}

#### Name and authenticate

Fill in a name for the destination and complete the authentication step. The form you see depends on the connector.
{% endstep %}

{% step %}

#### Confirm

Once authentication is validated, the destination is created with the status **Authenticated**.
{% endstep %}
{% endstepper %}

### Authentication methods

The method is set at the connector level, determined by the partner's requirements, so you get the relevant form automatically.

| Method                | What happens                                                                                                                                                         |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **OAuth 2.0**         | You are redirected to the partner's authorisation page. After granting access you are brought back, and the connection is established automatically.                 |
| **API Token**         | Enter the API key or token provided by the partner.                                                                                                                  |
| **Login / Password**  | Enter the credentials required by the partner.                                                                                                                       |
| **No authentication** | Some connectors need none. The destination is created directly - or authentication is handled on the mediarithmics side, in which case contact your Account Manager. |

## Keep the connection healthy

Each destination displays a status reflecting the health of its connection.

<table data-search="false"><thead><tr><th width="180">Status</th><th>Meaning</th></tr></thead><tbody><tr><td><strong>Authenticated</strong></td><td>The connection is active and valid. Presets and feeds can be created.</td></tr><tr><td><strong>Error</strong></td><td>The connection has failed - expired token, revoked access, invalid credentials. New presets and feeds cannot be created until the destination is re-authenticated.</td></tr><tr><td><strong>Unknown</strong></td><td>The connector does not use a managed authentication method. The connection is maintained outside the platform.</td></tr></tbody></table>

{% hint style="warning" %}
An **Error** status is not only a blocker on new work: feeds linked to that destination's presets may be unable to send data correctly. Re-authenticate to restore normal operation.
{% endhint %}

### Re-authenticate a destination

Required when the status is **Error**.

{% stepper %}
{% step %}

#### Open the destination

**Overview** tab, find the destination, and click **Edit Destination**.
{% endstep %}

{% step %}

#### Re-authenticate

Click **Re-authenticate**, and complete the connector's authentication flow.
{% endstep %}

{% step %}

#### Check the status

The status returns to **Authenticated** and linked feeds resume normal operation.
{% endstep %}
{% endstepper %}

## Rename or delete the destination

### Rename a destination

{% stepper %}
{% step %}

#### Open the destination

**Overview** tab, find the destination, and click **Edit Destination**.
{% endstep %}

{% step %}

#### Update the name

A warning shows how many active feeds the change affects. Confirm to apply.
{% endstep %}
{% endstepper %}

### Delete a destination

A destination can only be deleted if no preset is linked to it. Delete or reassign the presets first.

{% stepper %}
{% step %}

#### Open the destination

**Overview** tab, find the destination, and click **Edit Destination**.
{% endstep %}

{% step %}

#### Delete

Click **Delete** and confirm.
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
Deletion is permanent and cannot be undone.
{% endhint %}

## Verification

* The destination appears in the **Overview** tab of **Navigator > Feeds** with the status **Authenticated**.
* You can add a preset on it. See [Configure what you send to the partner](https://docs.mediarithmics.io/audience-and-activation/activate-your-audiences/set-up-a-connection-to-a-partner-platform/configure-what-you-send-to-the-partner.md).

## Related pages

<table data-view="cards" data-search="false"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Configure what you send to the partner</strong></td><td>The reusable configuration built on a destination.</td><td><a href="https://docs.mediarithmics.io/audience-and-activation/activate-your-audiences/set-up-a-connection-to-a-partner-platform/configure-what-you-send-to-the-partner.md">Configure what you send to the partner</a></td></tr><tr><td><strong>Set up a connection to a partner platform</strong></td><td>The levels, and the order to work in.</td><td><a href="https://docs.mediarithmics.io/audience-and-activation/activate-your-audiences/set-up-a-connection-to-a-partner-platform.md">Set up a connection to a partner platform</a></td></tr><tr><td><strong>Connectors on request</strong></td><td>When the partner you need has no connector yet.</td><td><a href="https://docs.mediarithmics.io/connectors/connectors-on-request.md">Connectors on request</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mediarithmics.io/audience-and-activation/activate-your-audiences/set-up-a-connection-to-a-partner-platform/connect-your-partner-account.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
