---
search:
  tags:
    - Assets
    - POST
seo:
  description: >-
    Available on: Meta TikTok. Reference for the POST
    /library/assets/{id}/registrations endpoint in the AdCrunch API.
sidebar:
  label: Register an Asset to an advertiser
  badge: POST
title: Register an Asset to an advertiser
type: openapi-operation
---
**Available on:** [![Meta](/providers/meta.svg)](https://docs.adcrunch.dev/connect/providers) [![TikTok](/providers/tiktok.svg)](https://docs.adcrunch.dev/connect/providers)

Places an Asset in the ad account of one **advertiser**. Not a provider — an organization has several advertisers, and the bytes land in exactly one of them.

Only a `ready` Asset can be registered.

Returns immediately with a `running` Registration; poll `GET /library/assets/{id}` for its state. Video can take several minutes to process at the provider, which is normal rather than a failure.

A Registration that is `running` or `ready` refuses a second one for the same pair. A `failed` one starts again: send this request, and AdCrunch replaces it.

`POST /library/assets/{id}/registrations`

**Request body** (`application/json`, required)

- `advertiserId` (string, required) — The advertiser whose ad account the bytes land in. Its provider decides how they get there.

Request body example:

```json
{
  "advertiserId": "acc_1203456789012345"
}
```

**Responses**

- `200` — The Registration, at \`running\`. \`providerIdentifier\` is \`null\` until the provider has the bytes — read the Asset to see it settle.
- `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.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`library:write\`. \`error\` is \`forbidden\`.
- `404` — No stored Asset with that id, or no such advertiser in this organization. The two are one answer, so the surface cannot be used to discover that an id is real. \`error\` is \`not\_found\`.
- `409` — The Asset cannot be registered. \`error\` is \`already\_registered\` when the Asset is already in the ad account of that advertiser, \`asset\_not\_ready\` when the Asset is \`pending\` (read it until it is \`ready\`), and \`asset\_failed\` when AdCrunch refused the file (the Asset carries \`failureCode\` and \`failureReason\`).

Response example, 200:

```json
{
  "advertiserId": "acc_1203456789012345",
  "assetId": "ast_7c1e9a",
  "createdAt": 1790000121000,
  "deletedAt": null,
  "failureCode": null,
  "failureReason": null,
  "id": "reg_4b81d2",
  "organizationId": "org_3a7f10",
  "provider": "meta",
  "providerIdentifier": null,
  "status": "running",
  "updatedAt": null,
  "uploadSessionId": null,
  "workflowId": "reg_4b81d2"
}
```
