AddUserEmailsToAudience

This action adds users to an existing Facebook Ads custom audience using either a single plain email address or a JSON array of plain email addresses.

Skyvia automatically trims leading and trailing whitespace, converts the addresses to lowercase, hashes them with SHA-256, and sends the hashes to Facebook Ads using the EMAIL_SHA256 schema.

Action Parameters

| Parameter | Description | |AudienceId| Facebook Ads Audience identifier. This parameter is required.| |Emails|Emails of the users to be added to the audience. This parameter is required.|

Result

The action submits the user data to Facebook Ads and returns the following fields:

|Field |Type |Description | |AudienceId |String |ID of the audience receiving the data. | |SessionId |String |Upload session ID returned by Facebook Ads. | |NumReceived |Int32 |Number of submitted user entries received by Facebook Ads for the session. This is not a count of matched audience members. | |NumInvalidEntries |Int32 |Number of entries reported as invalid by Facebook Ads. | |InvalidEntrySamples |String |Samples of invalid entries returned by Facebook Ads. |

Facebook processes audience updates asynchronously, so the audience's membership may not change immediately.