Create Ad Record

post https://api.triplewhale.com/api/v2/data-in/ads

Ingest ad data into Triple Whale. This endpoint allows users to upload detailed ad information, including campaign, adset, ad details, and performance metrics.

Body Params

shop

string

required

The domain of the shop (e.g., 'example.myshopify.com').

channel

string

required

Advertising channel (e.g., 'facebook-ads', 'google-ads').

channel_account_id

string

Defaults to CUSTOM_CHANNEL

The platform-specific account ID. Maps to account_id in the Ads table.

event_date

date

required

The date of the event in local timezone. Must be a valid date string (e.g., YYYY-MM-DD).

currency

string

required

The currency used for reporting (e.g., 'USD').

campaign

object

Details of the advertising campaign. At least one of campaign, adset, or ad is required.

adset

object

Details of the adset. At least one of campaign, adset, or ad is required.

object

Details of the individual ad. At least one of campaign, adset, or ad is required.

metrics

object

Performance metrics for the ad.

updated_at

date-time

The date and time of the last update. Defaults to the current timestamp in ISO format.

Responses

Language

Credentials

Header


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.triplewhale.com/api/v2/data-in/ads \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Ad record successfully received.

400Bad Request

429Too Many Requests

500Internal Server Error