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

# Meta Custom Audiences Connector

> Deliver custom audiences to Facebook and Instagram advertising

The Meta Custom Audiences Connector delivers audience data directly to Meta's Custom Audiences feature, enabling you to target users on Facebook and Instagram.

<Note>
  Looking to send conversion events instead? See the [Meta Conversions API Connector](/reference/connectors/meta-conversions-api).
</Note>

<iframe src="https://demo.arcade.software/8bV6cXfCroEMV1YZTfHH?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true" title="Meta Connector Demo" frameBorder="0" loading="lazy" allowFullScreen allow="clipboard-write" style={{ width: '100%', aspectRatio: '16/9' }} />

## Overview

The Meta Connector pushes your audience data to Meta's advertising platform, where it becomes available as a Custom Audience for targeting in your ad campaigns.

## Requirements

### Account access

* A Meta Business Manager account
* Admin access to the Ad Account where audiences will be created
* Appropriate permissions to create Custom Audiences

### Supported identifiers

Your data must include at least one of these identifier types, mapped to the corresponding Rosetta Stone attribute:

| Identifier Type               | Rosetta Stone Attribute                                                                                               |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| SHA256 hashed email           | [`sha256_hashed_email`](https://app.narrative.io/platform/rosetta-stone/attributes/sha256_hashed_email)               |
| Hashed email                  | [`hashed_email`](https://app.narrative.io/platform/rosetta-stone/attributes/hashed_email)                             |
| SHA256 hashed phone number    | [`sha256_hashed_phone_number`](https://app.narrative.io/platform/rosetta-stone/attributes/sha256_hashed_phone_number) |
| Phone number                  | [`telephone_number`](https://app.narrative.io/platform/rosetta-stone/attributes/telephone_number)                     |
| E.164 phone number            | [`e164_phone_number`](https://app.narrative.io/platform/rosetta-stone/attributes/e164_phone_number)                   |
| Apple IDFA                    | [`apple_idfa`](https://app.narrative.io/platform/rosetta-stone/attributes/apple_idfa)                                 |
| Android Advertising ID (GAID) | [`android_advertising_id`](https://app.narrative.io/platform/rosetta-stone/attributes/android_advertising_id)         |
| Narrative ID                  | [`narrative_id`](https://app.narrative.io/platform/rosetta-stone/attributes/narrative_id)                             |

The connector also accepts the generic [`unique_id`](https://app.narrative.io/platform/rosetta-stone/attributes/unique_id) and [`mobile_id_unique_identifier`](https://app.narrative.io/platform/rosetta-stone/attributes/mobile_id_unique_identifier) attributes when their `type` resolves to one of the identifiers above.

<Note>
  Hashed identifiers must use SHA256. See [Hashing PII for Upload](/guides/ingestion/hashing-pii) for formatting requirements.
</Note>

## Installation

<Steps>
  <Step title="Navigate to the connector">
    In Narrative, go to **Installed Apps** and select **Meta Connector**.
  </Step>

  <Step title="Authenticate with Meta">
    Click **Connect** and authorize Narrative to access your Meta Business Manager account.
  </Step>

  <Step title="Select your Ad Account">
    Choose the Ad Account where you want audiences to be created.
  </Step>
</Steps>

## Delivering audiences

Once configured, you can deliver datasets containing hashed identifiers to create Custom Audiences in Meta.

## Troubleshooting

### Ad account eligibility warnings

When you select an ad account during profile creation, Narrative flags accounts that may not be eligible for Custom Audience delivery. You can still select a flagged account and complete profile creation, but deliveries will fail until the underlying issue is resolved on Meta's side. See [Ad Account Eligibility for Custom Audiences](/guides/connectors/meta/ad-account-access) for detailed steps covering:

* Accepting the Custom Audiences Terms of Service
* Associating the ad account with a Business Manager
* Verifying role permissions
* Completing business verification

### Ads datasets not shown

Ads datasets are only available for profiles whose ad account is associated with a Business Manager. If a profile's ad account has no business association, the ads datasets table is hidden on the profile details page.

***

## Related content

<CardGroup cols={2}>
  <Card title="Meta Conversions API Connector" icon="meta" href="/reference/connectors/meta-conversions-api">
    Send conversion events for ad attribution
  </Card>

  <Card title="Data Activation Overview" icon="bullseye-arrow" href="/concepts/data-activation/overview">
    Understand how connectors deliver data
  </Card>

  <Card title="Hashing PII" icon="hashtag" href="/guides/ingestion/hashing-pii">
    Prepare identifiers for Meta
  </Card>
</CardGroup>