> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/saas-applications/appsflyer.md).

# AppsFlyer

Discover AppsFlyer account users and admins, and track daily dashboard sign-in activity across your organization

AppsFlyer is a mobile attribution and marketing analytics platform. The AppsFlyer integration connects your AppsFlyer account to Harmony as a SaaS Applications integration. Once connected, Harmony pulls the users of your AppsFlyer account with their roles, flags who holds admin access, and records which days each user signed in to the AppsFlyer dashboard.

### What the AppsFlyer integration enables

| Capability             | Description                                                                                   |
| ---------------------- | --------------------------------------------------------------------------------------------- |
| User Discovery         | Surface every user of your AppsFlyer account in Harmony's inventory with name, email and role |
| Admin Visibility       | See which users hold admin access, plus the AppsFlyer role each user is assigned              |
| Activity Tracking      | See which days each user signed in to the AppsFlyer dashboard                                 |
| Multi-Instance Support | Connect multiple AppsFlyer accounts for organizations with separate accounts                  |

### Prerequisites

1. **An AppsFlyer Admin** - only Admins can view and create API tokens. The integration reads the account's users and roles through AppsFlyer's User Management API, which is available to advertiser accounts.
2. **For sign-in activity: AppsFlyer's Enterprise-Grade Security Package.** Sign-ins come from AppsFlyer's audit log, and only this package includes API access to it. Without it, users and roles still sync, and sign-in activity stays empty.
3. **A Harmony account** with admin privileges

### Credentials

The AppsFlyer integration uses one value:

* **API V2 Token** - an AppsFlyer API token (V2). This value is masked in Harmony after you save it.

{% hint style="warning" %}
AppsFlyer revoked every API V2 token generated before March 10, 2026. If your token is older, create a new one.
{% endhint %}

### Connecting AppsFlyer to Harmony

#### Step 1: Get an AppsFlyer API V2 token

1. Log in to AppsFlyer as an Admin
2. From the top bar, open the account menu (your email address) and click **Security center**
3. In the **AppsFlyer API tokens** section, click **Manage your AppsFlyer API tokens**
4. Copy an existing **API** token, or click **+ New token**, enter a name (for example, `Harmony Integration`), select the **API** token type and click **Create token**

{% hint style="info" %}
API V2 tokens are active as soon as they are created. AppsFlyer allows up to two tokens per type on the standard package, and the same API token can serve several uses.
{% endhint %}

{% hint style="warning" %}
**Use a token with no service restrictions.** With the Enterprise-Grade Security Package, tokens can be limited to specific services. Harmony needs both user management and the audit log, so a token restricted to one of them leaves part of the integration empty. If your account restricts API calls to an **IP allowlist**, contact Harmony Support for the addresses Harmony connects from and add them.
{% endhint %}

#### Step 2: Enter the token in Harmony

1. Log in to your Harmony dashboard
2. Go to **Settings** > **Integrations**
3. Find **AppsFlyer** under **SaaS Applications** (or search for it by name) and click its card
4. If an AppsFlyer instance is already connected, click **+ Create instance**
5. Enter an **Instance name** (required), for example the name of your AppsFlyer account
6. Paste the token from Step 1 into **API V2 Token**
7. Click **Connect**

{% hint style="info" %}
Harmony validates the token at save time by reading your account's user list from AppsFlyer, and checks whether the account can read its audit log. If AppsFlyer rejects the token, the save fails immediately with an error. If the audit log is not available (no Enterprise-Grade Security Package), the integration still connects and syncs users and roles.
{% endhint %}

### Disconnecting AppsFlyer from Harmony

1. Log in to your Harmony dashboard
2. Navigate to **Settings** > **Integrations**
3. Find **AppsFlyer** under **SaaS Applications** and click the integration card
4. Click the delete (trash) icon next to the instance you want to remove, and confirm when prompted

Once disconnected, Harmony stops syncing data from AppsFlyer. Previously synced data remains available in Harmony. You can also delete the token in AppsFlyer under **Security center** > **Manage your AppsFlyer API tokens**.

### What Harmony Syncs from AppsFlyer

| Data             | Description                                                                                                                                                                                                         |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Account users    | Username, email, and the apps, media sources and geos each user can access, as AppsFlyer reports them                                                                                                               |
| Roles            | **Admin** for users with AppsFlyer's Admin role (including the account owner) or a custom role that grants every capability at full access, **member** for everyone else, plus the AppsFlyer role name of each user |
| Sign-in activity | The days each user signed in to or out of the AppsFlyer dashboard. A user counts as active at most once per day                                                                                                     |

Only dashboard sign-ins count as activity. People who use AppsFlyer only through its API or MCP, with a token, are not tracked as active, because the audit log records those calls against the token rather than a person.

{% hint style="info" %}
**Sync frequency:**

* **Users and roles** refresh every 6 hours
* **Sign-in activity** is collected once a day for each finished day (UTC), so a sign-in shows up in Harmony about a day later
  {% endhint %}

{% hint style="info" %}
**Historical data on first connection:**

On the first sync, Harmony collects up to **90 days** of sign-in activity. Later syncs continue from where the previous one stopped.
{% endhint %}

#### What Harmony does not sync

* **Licensed seat count and per-user seat type.** AppsFlyer's API does not expose seats or licences per user. Record the number of seats you purchased on the AppsFlyer contract in Harmony.
* **Pending invitations.** AppsFlyer's dashboard marks users who have not activated their account yet, but its API does not report it, so Harmony does not show user status.
* **Department.** AppsFlyer's user list does not return it.
* **Attribution, campaign or app data.** Harmony reads users, roles and dashboard sign-ins only.

### Permissions Explained

AppsFlyer API V2 tokens are account-wide. Harmony uses the token only for these read operations:

| AppsFlyer endpoint                                 | What Harmony reads                                           |
| -------------------------------------------------- | ------------------------------------------------------------ |
| `GET /api/user-management/v1.0/users`              | The account's users and their roles                          |
| `GET /api/user-management/v1.0/roles`              | Each role's capabilities and members, to identify admins     |
| `GET /api/audit/v1.0/logs` (System access entries) | Dashboard sign-ins and sign-outs, one finished day at a time |

{% hint style="info" %}
AppsFlyer allows **100 user-management API calls per day** per account, shared by every tool your company uses. Harmony uses 8 a day (users and roles every 6 hours), plus one each time the integration is saved.
{% endhint %}

### Use Cases

<details>

<summary>Seat Utilization</summary>

Compare the number of AppsFlyer users with the seats on your AppsFlyer contract, and find users who have not signed in to the dashboard in weeks before your next renewal.

</details>

<details>

<summary>Access Review</summary>

Review who holds admin access in AppsFlyer and which role each user is assigned.

</details>

<details>

<summary>Offboarding</summary>

Confirm that departing employees have been removed from AppsFlyer as part of Harmony offboarding workflows.

</details>

### Troubleshooting

<details>

<summary>"AppsFlyer rejected the API token"</summary>

**Possible causes:**

* The token was copied incorrectly
* The token was deleted in AppsFlyer, or was generated before March 10, 2026 and revoked by AppsFlyer
* The token is restricted away from the user management service

**Solutions:**

1. Copy an active API token from **Security center** > **Manage your AppsFlyer API tokens**, or create a new one with no service restrictions
2. Enter the token in Harmony

</details>

<details>

<summary>Users sync, but sign-in activity is empty</summary>

**Possible causes:**

* Your AppsFlyer account does not have the Enterprise-Grade Security Package, which is required for API access to the audit log
* The token is restricted away from the Audit log service

**Solutions:**

1. Ask your AppsFlyer account manager about the Enterprise-Grade Security Package, or use a token with no service restrictions
2. Then open the AppsFlyer instance in Harmony and save it again. Harmony re-checks audit log access on save and starts collecting sign-ins

</details>

<details>

<summary>The integration worked and then started failing</summary>

**Possible causes:**

* The token was deleted or replaced in AppsFlyer
* An IP allowlist was added without Harmony's addresses
* Your account used up its 100 daily user-management API calls with other tools

**Solutions:**

1. If the token was deleted, delete the AppsFlyer instance in Harmony and create it again with a new token (the token cannot be changed on a connected instance)
2. If an IP allowlist blocks Harmony, add Harmony's addresses (contact Harmony Support for them)
3. If the daily limit was reached, Harmony retries after it resets, and syncs resume on their own

</details>

<details>

<summary>A user who uses AppsFlyer shows as inactive</summary>

**Possible causes:**

* The user works with AppsFlyer only through its API or MCP, which the audit log attributes to a token, not a person
* Your account does not have the Enterprise-Grade Security Package, so no sign-in activity is collected

**Solutions:**

1. Check the user's dashboard sign-ins in AppsFlyer's audit log (**Security center** > **View audit log**)

</details>

### Data & Privacy

<details>

<summary>Key privacy principles</summary>

For information about how Harmony handles your data, see our [Privacy Policy](https://harmony.io/privacy).

* Harmony accesses AppsFlyer data in read-only mode and never creates, edits or deletes AppsFlyer users or settings
* Harmony reads users, roles and dashboard sign-in entries. It does not access attribution, campaign, app or end-user data
* Access can be revoked at any time by deleting the token in AppsFlyer or disconnecting the integration in Harmony

</details>


---

# 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.harmony.io/integrations/saas-applications/appsflyer.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.
