> For the complete documentation index, see [llms.txt](https://docs.adpage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adpage.io/data-and-insights/marketing-integrations/returnista.md).

# Returnista

Connect Returnista to see returns and return rate per channel and campaign — and what your advertising really earned.

Connect Returnista so AdPage knows what came back. Returns are the difference between revenue and income, and a channel with a 40% return rate is not the channel your ROAS says it is.

AdPage only reads. It cannot create, approve or change a return.

### Before you start

You need two values from Returnista:

* Your **account ID**.
* A **Service User API key**.

Both come from your Returnista account. If you cannot find the Service User section, Returnista support creates these — it is a standard request, and the key is meant for exactly this kind of integration.

### Connect Returnista

{% stepper %}
{% step %}

#### Open the tile

Go to **Integrations**, select the container, and open the **Returnista** tile.

<figure><img src="https://1954565367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FK5kjEu8mwstNkOrvFl6S%2Fuploads%2FjG7b4RbJk14mv5Lm09no%2Fintegrations-returnista-tile-en.webp?alt=media" alt="Returnista tile opened on the Integrations page"><figcaption><p>The Returnista tile on the Integrations page.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Paste the account ID and API key

Fill in both values and connect.
{% endstep %}

{% step %}

#### Wait for the first sync

AdPage verifies the credentials against Returnista before storing them, then immediately starts an initial sync of your return history. Credentials that fail are never saved.

The first sync takes a few minutes on a large history. After that, returns are kept up to date automatically.
{% endstep %}
{% endstepper %}

### What you get

The **Returns** view inside **Business & Revenue**:

* **Return rate per channel** — which traffic sources bring customers who send things back.
* **Return rate per campaign** — the same question one level down, where the differences are usually larger.
* **Net revenue** — revenue after returns, which is the figure that should drive budget decisions.
* **Return reasons** — how often each reason comes up and how much return value is behind it.

This is the integration that most often changes someone's mind. A campaign with a strong ROAS and a 45% return rate can be worth less than one that looks mediocre and keeps its sales — and nothing else in your reports will tell you that.

Returns also flow into **Profit on Adspend** when it is based on your order webhooks: a net ROAS, and a profit that subtracts what returns cost you.

And you can send them to Google Ads. With [Returns to Google Ads](https://docs.adpage.io/optimize-your-setup/returns-to-google-ads) switched on, AdPage retracts or lowers the conversions of returned orders, so Smart Bidding optimizes on the revenue you keep.

### Reading the numbers

{% hint style="warning" %}
**A return lands weeks after the sale.** A customer buys in week 1 and returns in week 4, so the current month's return rate always looks better than it will turn out to be. Never compare a recent period's return rate against a settled one — the recent one is incomplete by definition, not better.
{% endhint %}

**Return rate is a property of the product as much as the channel.** Clothing returns more than electronics. A channel selling mostly apparel will show a higher rate without performing worse. Compare like for like.

**Returns are attributed to the original order.** So a channel's return rate reflects the traffic that made the sale, which is exactly what you want for budget decisions — but it means a channel's history keeps changing as returns arrive.

### Troubleshooting

**The credentials are rejected.** Check the account ID and the key. A regular user API key is not a Service User key; only the latter works for integrations.

**Connected, but no returns.** Either the account genuinely has no returns in the period, or the initial sync is still running. Give it a few minutes and check the period.

**Return rate looks impossibly low.** Check the period — see the warning above. A recent period has not had time to accumulate returns.

**Returns do not line up with orders.** Returns are matched to the original order, so a return of an order from before your webshop integration was connected has nothing to attach to.

Still stuck? Contact <support@adpage.io> with the container and the account ID — never the key.


---

# 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.adpage.io/data-and-insights/marketing-integrations/returnista.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.
