Record what a Line Item spawned

Records one provider object that this Line Item created. The caller that created the object writes this record, because only that caller knows which line the object belongs to.

A record is a fact, not an attempt. AdCrunch keeps the attempts in the mutation ledger.

This call refuses almost nothing. The provider object already exists, and a refusal would leave it live and untracked. A draft line records, an edited line records, and a line on a channel AdCrunch cannot write to records. The state of the line does not change, and neither does the state of the Campaign Plan.

The same object recorded again answers 200 with the existing row, and not 201. The same object is the same provider, the same level and the same native id, on the same line.

AdCrunch never removes a record. It can tell you how many objects a line created. It cannot tell you how many objects a line must create, because a Campaign Plan never declares that number.

POST/context/campaign-plans/{slug}/line-items/{lineItemId}/executions

Authorization

AuthorizationBearer token · headerrequired

Send Authorization: Bearer <credential>.

Use an API key (acr_…), from the AdCrunch console under Settings → API keys.

The credential names the organization, and no operation takes an organization parameter.

See https://docs.adcrunch.dev/api/authentication.

Path parameters

lineItemIdstringrequired

matches ^lni_[\s\S]{0,}$

slugstringrequired

Request body

requiredapplication/json

advertiser_idstringrequired

The ad account the object was created in.

matches ^acc_[\s\S]{0,}$

entity_idstringrequired

The native provider id, unprefixed — exactly as the Insight entities table holds it, which is what makes the two joinable.

min length 1

entity_typestringrequired

The provider’s own word for the level: campaign, adset, ad. Free text, because the vocabulary is the provider’s.

min length 1

mutation_workflow_idstring

The mutation that performed the write, when known — links this fact to the attempt without either duplicating the other.

min length 1

providerstringrequired

Show properties

Any of:

string

string

string

string

string

string

string

string

string

string

string

string

string

string

Responses

200

This object was already recorded against this line. The existing row comes back unchanged, so the call is idempotent — recording twice does not inflate what the line has spawned.

advertiserIdstringrequired

createdAtnumberrequired

Milliseconds since the Unix epoch, UTC.

entityIdstringrequired

The provider’s own id, unprefixed, so it joins to entities.

entityTypestringrequired

The provider’s word for the level — campaign, adset, ad.

idstringrequired

mutationWorkflowIdstring | nullrequired

The durable execution that performed the write, when known.

providerstringrequired

201

Recorded. Neither response shape was observed against the deployed service, because the verification organization has no connected advertiser — both are written from the Context Layer’s view type.

advertiserIdstringrequired

createdAtnumberrequired

Milliseconds since the Unix epoch, UTC.

entityIdstringrequired

The provider’s own id, unprefixed, so it joins to entities.

entityTypestringrequired

The provider’s word for the level — campaign, adset, ad.

idstringrequired

mutationWorkflowIdstring | nullrequired

The durable execution that performed the write, when known.

providerstringrequired

400

The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. error is invalid_request, and issues names each field. Nothing was changed.

issuesobject[]required

One entry for each field that does not match.

Show properties

Array of object

instringrequired

The part of the request that holds the field.

Allowed:bodycookieheadersparamsquery

messagestringrequired

A sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.

pathstringrequired

A JSON Pointer into that part of the request, such as /filename. An empty string is the whole part.

errorstringrequired

A stable code for the failure. This is the field to branch on. It does not change for a given failure.

Allowed:invalid_request

messagestringrequired

A sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.

401

No API key, or one that does not resolve. See the security scheme. error is unauthorized.

errorstringrequired

A stable code for the failure. This is the field to branch on. It does not change for a given failure.

Allowed:unauthorized

messagestringrequired

A sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.

403

The caller does not hold campaign_plan:write. error is forbidden.

errorstringrequired

A stable code for the failure. This is the field to branch on. It does not change for a given failure.

Allowed:forbidden

messagestringrequired

A sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.

404

No such plan, or no Line Item with that id on it. error is not_found.

errorstringrequired

A stable code for the failure. This is the field to branch on. It does not change for a given failure.

messagestringrequired

A sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.

422

That ad account is not connected to this organization. error is advertiser_not_owned. Almost nothing else is refused here, deliberately: the provider object already exists, and refusing the record would leave it live and untracked.

errorstringrequired

A stable code for the failure. This is the field to branch on. It does not change for a given failure.

messagestringrequired

A sentence to show a person. Written to say what to do next. Reworded whenever it can be said better, so never branch on it.

Request

curl -X POST "https://api.pr-701.adcrunch.dev/context/campaign-plans/string/line-items/string/executions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "advertiser_id": "acc_1203456789012345",
  "entity_id": "23861234567890123",
  "entity_type": "campaign",
  "mutation_workflow_id": "b3d1f0c4-6a2e-4a1f-9f77-2c0d1e5a8b94",
  "provider": "meta"
}'

const response = await fetch("https://api.pr-701.adcrunch.dev/context/campaign-plans/string/line-items/string/executions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"advertiser_id\": \"acc_1203456789012345\",\n  \"entity_id\": \"23861234567890123\",\n  \"entity_type\": \"campaign\",\n  \"mutation_workflow_id\": \"b3d1f0c4-6a2e-4a1f-9f77-2c0d1e5a8b94\",\n  \"provider\": \"meta\"\n}"
});

import requests

response = requests.post(
    "https://api.pr-701.adcrunch.dev/context/campaign-plans/string/line-items/string/executions",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"advertiser_id\": \"acc_1203456789012345\",\n  \"entity_id\": \"23861234567890123\",\n  \"entity_type\": \"campaign\",\n  \"mutation_workflow_id\": \"b3d1f0c4-6a2e-4a1f-9f77-2c0d1e5a8b94\",\n  \"provider\": \"meta\"\n}",
)

Response

{
  "advertiserId": "acc_1203456789012345",
  "createdAt": 1772409600000,
  "entityId": "120210000000000",
  "entityType": "campaign",
  "id": "exe_7a4c12",
  "mutationWorkflowId": "b3d1f0c4-6a2e-4a1f-9f77-2c0d1e5a8b94",
  "provider": "meta"
}

{
  "advertiserId": "acc_1203456789012345",
  "createdAt": 1772409600000,
  "entityId": "120210000000000",
  "entityType": "campaign",
  "id": "exe_7a4c12",
  "mutationWorkflowId": "b3d1f0c4-6a2e-4a1f-9f77-2c0d1e5a8b94",
  "provider": "meta"
}

{
  "issues": [
    {
      "in": "body",
      "message": "string",
      "path": "string"
    }
  ],
  "error": "invalid_request",
  "message": "string"
}

{
  "error": "unauthorized",
  "message": "string"
}

{
  "error": "forbidden",
  "message": "string"
}

{
  "error": "string",
  "message": "string"
}

{
  "error": "string",
  "message": "string"
}