# Meta Custom Audiences

> Create customer-list audiences, add or remove members, and manage audience sharing.

App · 12 actions. Web page: https://docs.lodol.com/docs/integrations/meta-custom-audiences

## Actions

### Add members

Add members in Meta Custom Audiences.

**Inputs**

- Audience (`audience_id`, text, required): Audience ID.
- Identifier type (`identifier_type`, text, required): Identifier type. One of: `EMAIL`, `PHONE`.
- Identifiers (`identifiers`, list, required): Identifiers.

**Outputs**

- `data` (object): Meta Custom Audiences response data.

**Example output**

```json
{
  "data": {
    "audience_id": "example",
    "num_invalid_entries": 1,
    "num_received": 1,
    "session_id": "example"
  }
}
```

### Create audience

Create audience in Meta Custom Audiences.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account ID.
- Name (`name`, text, required): Name.
- Description (`description`, text): Description.
- Customer file source (`customer_file_source`, text, required): Customer file source. One of: `USER_PROVIDED_ONLY` (User provided only), `PARTNER_PROVIDED_ONLY` (Partner provided only), `BOTH_USER_AND_PARTNER_PROVIDED` (Both user and partner provided).
- Retention days (`retention_days`, number): Retention days. From 1 to 180.

**Outputs**

- `data` (object): Meta Custom Audiences response data.

**Example output**

```json
{
  "data": {
    "id": "example"
  }
}
```

### Delete audience

Delete audience in Meta Custom Audiences.

**Inputs**

- Audience (`audience_id`, text, required): Audience ID.

**Outputs**

- `data` (object): Meta Custom Audiences response data.

**Example output**

```json
{
  "data": {
    "success": false
  }
}
```

### Get ad account

Get ad account in Meta Custom Audiences.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account ID.

**Outputs**

- `data` (object): Meta Custom Audiences response data.

**Example output**

```json
{
  "data": {
    "account_id": "example",
    "id": "example",
    "name": "example"
  }
}
```

### Get audience

Get audience in Meta Custom Audiences.

**Inputs**

- Audience (`audience_id`, text, required): Audience ID.

**Outputs**

- `data` (object): Meta Custom Audiences response data.

**Example output**

```json
{
  "data": {
    "delivery_status": {},
    "description": "example",
    "id": "example",
    "name": "example",
    "operation_status": {},
    "subtype": "example",
    "time_updated": 1
  }
}
```

### List ad accounts

List ad accounts in Meta Custom Audiences.

**Inputs**

- After (`after`, text): After.
- Limit (`limit`, number): Limit. From 1 to 100.

**Outputs**

- `data` (object): Meta Custom Audiences response data.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass this value to the next page input.
- `records` (list): The records on this page.

**Example output**

```json
{
  "data": {
    "data": [],
    "paging": {}
  },
  "has_more": false,
  "next_cursor": null,
  "records": []
}
```

### List audiences

List audiences in Meta Custom Audiences.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account ID.
- After (`after`, text): After.
- Limit (`limit`, number): Limit. From 1 to 100.

**Outputs**

- `data` (object): Meta Custom Audiences response data.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass this value to the next page input.
- `records` (list): The records on this page.

**Example output**

```json
{
  "data": {
    "data": [],
    "paging": {}
  },
  "has_more": false,
  "next_cursor": null,
  "records": []
}
```

### List shared accounts

List shared accounts in Meta Custom Audiences.

**Inputs**

- Audience (`audience_id`, text, required): Audience ID.
- After (`after`, text): After.
- Limit (`limit`, number): Limit. From 1 to 100.
- Permissions (`permissions`, text): Permissions. One of: `targeting`, `targeting_and_insights` (Targeting and insights).

**Outputs**

- `data` (object): Meta Custom Audiences response data.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass this value to the next page input.
- `records` (list): The records on this page.

**Example output**

```json
{
  "data": {
    "data": [],
    "paging": {}
  },
  "has_more": false,
  "next_cursor": null,
  "records": []
}
```

### Remove members

Remove members in Meta Custom Audiences.

**Inputs**

- Audience (`audience_id`, text, required): Audience ID.
- Identifier type (`identifier_type`, text, required): Identifier type. One of: `EMAIL`, `PHONE`.
- Identifiers (`identifiers`, list, required): Identifiers.

**Outputs**

- `data` (object): Meta Custom Audiences response data.

**Example output**

```json
{
  "data": {
    "audience_id": "example",
    "num_invalid_entries": 1,
    "num_received": 1,
    "session_id": "example"
  }
}
```

### Share audience

Share audience in Meta Custom Audiences.

**Inputs**

- Audience (`audience_id`, text, required): Audience ID.
- Ad accounts (`ad_accounts`, list, required): Ad accounts.
- Permissions (`permissions`, text): Permissions. One of: `targeting`, `targeting_and_insights` (Targeting and insights).

**Outputs**

- `data` (object): Meta Custom Audiences response data.

**Example output**

```json
{
  "data": {
    "success": false
  }
}
```

### Unshare audience

Unshare audience in Meta Custom Audiences.

**Inputs**

- Audience (`audience_id`, text, required): Audience ID.
- Ad accounts (`ad_accounts`, list, required): Ad accounts.

**Outputs**

- `data` (object): Meta Custom Audiences response data.

**Example output**

```json
{
  "data": {
    "success": false
  }
}
```

### Update audience

Update audience in Meta Custom Audiences.

**Inputs**

- Audience (`audience_id`, text, required): Audience ID.
- Name (`name`, text): Name.
- Description (`description`, text): Description.

**Outputs**

- `data` (object): Meta Custom Audiences response data.

**Example output**

```json
{
  "data": {
    "success": false
  }
}
```
