curl --request POST \
--url https://app.bily.ai/api/customer/v1/platform/{resourceUrl}/actions/manage-pinterest-asset \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"adAccountId": "<string>",
"sourceAuthority": {
"dataSourceAdAccountId": "<string>",
"dataSourceConnectorId": "<string>"
},
"payload": {
"operation": "create-adgroup",
"campaignId": "<string>",
"expectedFingerprint": "<string>",
"name": "<string>",
"countries": [
"<string>"
],
"status": "PAUSED",
"budget": 123,
"endTime": 2
}
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
adAccountId: '<string>',
sourceAuthority: {dataSourceAdAccountId: '<string>', dataSourceConnectorId: '<string>'},
payload: {
operation: 'create-adgroup',
campaignId: '<string>',
expectedFingerprint: '<string>',
name: '<string>',
countries: ['<string>'],
status: 'PAUSED',
budget: 123,
endTime: 2
}
})
};
fetch('https://app.bily.ai/api/customer/v1/platform/{resourceUrl}/actions/manage-pinterest-asset', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.bily.ai/api/customer/v1/platform/{resourceUrl}/actions/manage-pinterest-asset"
payload = {
"adAccountId": "<string>",
"sourceAuthority": {
"dataSourceAdAccountId": "<string>",
"dataSourceConnectorId": "<string>"
},
"payload": {
"operation": "create-adgroup",
"campaignId": "<string>",
"expectedFingerprint": "<string>",
"name": "<string>",
"countries": ["<string>"],
"status": "PAUSED",
"budget": 123,
"endTime": 2
}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}Create Pinterest Ad Groups and Image Ads (Paused First)
Create a paused standard Awareness or Consideration ad group under the selected campaign, respecting campaign budget ownership; create a paused image ad from a new ad-only Pin; create a new image variation without editing the source ad; or duplicate a standard ad-only image ad. Requires the current source fingerprint. Completion requires provider readback. Partial Pin and ad IDs remain recovery references and uncertain writes must not be replayed. This is an execution endpoint. For a reviewed user change, save its supported capability/body as an immutable action draft, review it, and explicitly publish that draft. Check action-jobs/capabilities before staging; a catalog entry alone does not make it stageable.
curl --request POST \
--url https://app.bily.ai/api/customer/v1/platform/{resourceUrl}/actions/manage-pinterest-asset \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"adAccountId": "<string>",
"sourceAuthority": {
"dataSourceAdAccountId": "<string>",
"dataSourceConnectorId": "<string>"
},
"payload": {
"operation": "create-adgroup",
"campaignId": "<string>",
"expectedFingerprint": "<string>",
"name": "<string>",
"countries": [
"<string>"
],
"status": "PAUSED",
"budget": 123,
"endTime": 2
}
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
adAccountId: '<string>',
sourceAuthority: {dataSourceAdAccountId: '<string>', dataSourceConnectorId: '<string>'},
payload: {
operation: 'create-adgroup',
campaignId: '<string>',
expectedFingerprint: '<string>',
name: '<string>',
countries: ['<string>'],
status: 'PAUSED',
budget: 123,
endTime: 2
}
})
};
fetch('https://app.bily.ai/api/customer/v1/platform/{resourceUrl}/actions/manage-pinterest-asset', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.bily.ai/api/customer/v1/platform/{resourceUrl}/actions/manage-pinterest-asset"
payload = {
"adAccountId": "<string>",
"sourceAuthority": {
"dataSourceAdAccountId": "<string>",
"dataSourceConnectorId": "<string>"
},
"payload": {
"operation": "create-adgroup",
"campaignId": "<string>",
"expectedFingerprint": "<string>",
"name": "<string>",
"countries": ["<string>"],
"status": "PAUSED",
"budget": 123,
"endTime": 2
}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}{
"error": "Store not found",
"requestId": "<string>",
"details": "<unknown>",
"retryAfter": "<string>"
}Authorizations
A server-side Bily API key created under Settings > AI tools > Access keys. Select the intended workspace before creating it.
Headers
An organization ID returned by GET /context or GET /organizations. Omit it when a scoped key supplies the organization. Otherwise provide it when no organization is selected.
"org_01J8W7T9G3E6ZQ4M2K5N8P1R0S"
Path Parameters
Exact workspace URL returned by GET /context.
Body
Response
Request completed. Inspect the returned state and any verification fields.
The response is of type object.