Configure destinations for Reddit Ads

Reddit Ads connects brands to more than 490 million weekly visitors across the 100K+ active communities on Reddit. Reddit users come to the platform with specific research intent, looking for product information and peer recommendations from communities organized around shared interests and expertise. Ninety percent of Reddit users trust the platform to learn about new products and brands, making it a high-intent environment for ad targeting.

Use Amperity to build audience segments and send them to Reddit Ads as custom audiences for ad targeting. Amperity normalizes and SHA-256 hashes email addresses before sending them to Reddit Ads, where they are matched to Reddit accounts and made available for campaign targeting.

Note

This destination uses the Reddit Ads API v3 .

How this destination works

Amperity sends audience data to Reddit Ads using an incremental workflow. Each run sends only additions and removals since the previous run. Amperity creates the custom audience in Reddit Ads automatically on the first run and reuses it on subsequent runs.

A Reddit Ads destination works like this:

	AUTHENTICATE Amperity authenticates to Reddit Ads using an OAuth2 refresh token. Amperity exchanges the refresh token for a short-lived access token, which is used for all API requests in the workflow.
	RESOLVE CUSTOM AUDIENCE Amperity searches the ad account for a custom audience that matches the configured name. The search is case-insensitive and compares exact names across all audiences in the account. If no matching audience is found, Amperity creates a new CUSTOMER_LIST custom audience using the POST /api/v3/ad_accounts/{id}/custom_audiences endpoint. When no list name is configured, the audience name defaults to “Amperity - “ followed by the segment name. The Reddit audience ID is stored internally and used on subsequent runs. If the audience is deleted in Reddit Ads and recreated, Amperity detects the mismatch and rebuilds the full membership on the next run.
	NORMALIZE AND HASH EMAILS Reddit Ads requires email normalization to values in the email column before hashing email addresses. Amperity: Converts to lowercase and trims whitespace. Strips +alias suffixes from the local part (user+tag@example.com becomes user@example.com). Removes dots from the local part (f.i.r.s.t@example.com becomes first@example.com). SHA-256 hashes the result. Rows with a missing or unparseable email address are counted as failed rows.
	SEND ADDITIONS Amperity sends new audience members to Reddit Ads using the PATCH /api/v3/custom_audiences/{id}/users endpoint with action type ADD, in batches of up to 2,500 rows with five concurrent requests. Additions are always sent before removals to preserve the 1,000-user minimum audience threshold required by Reddit Ads.
	SEND REMOVALS AND END WORKFLOW Audience members removed from the segment in Amperity are sent to Reddit Ads using the same endpoint with action type REMOVE, in batches of up to 2,500 rows with five concurrent requests. The workflow ends after all additions and removals are sent.

Send audiences via SFTP

You can also send audience data to Reddit Ads as a CSV file using SFTP. Contact your Reddit Ads representative for SFTP credentials and file format requirements, and then configure Amperity to connect to Reddit Ads using the SFTP destination.

Get details

Review the following details before configuring credentials for Reddit Ads and before configuring Amperity to send audience segments to Reddit Ads.

	Credential settings Refresh token Required The OAuth2 refresh token for the Reddit Ads account. This token is issued by Reddit during the OAuth2 authorization flow and should be treated as a secret. Tip Contact your Reddit Ads representative to initiate the OAuth2 authorization flow and obtain a refresh token.
	Required destination settings Ad account ID Required The Reddit Ads account ID. This value follows the format a2_xxxxxxxxx and is available in Reddit Ads Manager under account settings.
	Optional orchestration settings List name Optional. The name of the custom audience in Reddit Ads. When provided, this name is used as-is. When omitted, the audience name defaults to “Amperity - “ followed by the segment name. Audience primary key Required The primary key for the audience. Set to “email”.
	A query or segment that returns an email column. Amperity normalizes and hashes email addresses before sending them to Reddit Ads.

Configure credentials

Configure credentials for Reddit Ads before adding a destination.

An individual with access to Reddit Ads should use SnapPass to securely share “refresh token” details with the individual who configures Amperity.

To configure credentials for Reddit Ads

	From the Settings page, select the Credentials tab, and then click the Add credential button.
	In the Credentials settings dialog box, do the following: From the Plugin dropdown, select Reddit Ads. Assign the credential a name and description that ensures other users of Amperity can recognize when to use this destination.
	The settings that are available for a credential vary by credential type. For the “reddit” credential type, configure settings, and then click Save. Refresh token Required The OAuth2 refresh token for the Reddit Ads account. This token is issued by Reddit during the OAuth2 authorization flow and should be treated as a secret.

Add destination

Use a sandbox to configure a destination for Reddit Ads. Before promoting your changes, send a sample audience, and then verify the results in Reddit Ads. After verifying the end-to-end workflow, push the destination from the sandbox to production.

To add a destination for Reddit Ads

	Open the Destinations page, select the New destinations button, and then select Orchestration. To configure a destination for Reddit Ads, do one of the following: Click the row in which Reddit Ads is located. Destinations list alphabetically and you can scroll up and down the list. Search for Reddit Ads. Start typing “red”. The list filters to show only matching destinations. Select “Reddit”.
	Select the credential for Reddit Ads from the Credential dropdown, and then click Continue. Tip Amperity validates the connection when the destination is saved. If the connection cannot be validated, an error is shown and the destination is not saved.
	In the “Destination settings” dialog box, assign the destination a name and description that ensures other users of Amperity can recognize when to use this destination. Configure business user access By default a destination is available to all users who have permission to view personally identifiable information (PII). Enable the Admin only checkbox to restrict access to only users assigned to the Datagrid Operator and Datagrid Administrator policies. Enable the PII setting checkbox to allow limited access to PII for this destination. Use the Restrict PII access policy option to prevent users from viewing data marked as PII anywhere in Amperity and from sending data to downstream workflows.
	Configure the following settings, and then click “Save”. Ad account ID Required The Reddit Ads account ID. This value follows the format a2_xxxxxxxxx and is available in Reddit Ads Manager under account settings. List name (Optional) Optional. The name of the custom audience in Reddit Ads. When provided, this name is used as-is. When omitted, the audience name defaults to “Amperity - “ followed by the segment name. Audience primary key The primary key for the audience. Set to “email”.
	After configuring this destination users may use: Orchestrations to send query results Orchestrations and campaigns to send audiences Orchestrations and campaigns to send events
	Validate the audience with Reddit Ads by using a sample audience with a very small membership. For example: 10 or 100 members or the minimum audience size recommended by Reddit Ads. Send the sample audience to Reddit Ads and verify the sample audience is correct in Reddit Ads. Make adjustments if necessary. Only send full audiences after validation is complete.