---
title: "Update ad account settings"
method: PATCH
path: "/v1/ads/accounts"
tags: ["Ad Accounts"]
---

# Update ad account settings

`PATCH /v1/ads/accounts`

Sets the default DSA beneficiary and payor on a Meta ad account (EU DSA, Article 26).
Set them once and every EU-targeted call to `/v1/ads/create`, `/v1/ads/boost` and
`/v1/ads/ctwa` on that ad account can omit `dsaBeneficiary`/`dsaPayor`: Meta applies
the defaults automatically.

The values are written to the ad account on Meta, the same setting Ads Manager edits.
Nothing is stored in Zernio, and defaults already set in Ads Manager work identically.
Zernio never guesses these values for you. Beneficiary and payor are legal disclosures
shown to EU users, so you must provide the entity names explicitly. Use
`GET /v1/ads/dsa-recommendations` to offer suggestions in your UI.

If `defaultDsaPayor` is omitted, the beneficiary is also set as the payor, which
covers the common case where the same entity benefits from and pays for the ads.
Read the current values back with `GET /v1/ads/dsa-defaults`.

Currently supported for Meta accounts only; other platforms return 400.

## Request body

- object
  - `accountId` string, required — Social account ID (metaads, or a facebook/instagram posting account)
  - `adAccountId` string, required — Meta ad account ID (act_...)
  - `defaultDsaBeneficiary` string, required — Legal entity benefiting from ads on this ad account
  - `defaultDsaPayor` string — Legal entity paying for ads on this ad account. Defaults to defaultDsaBeneficiary when omitted.

## Response `200`

DSA defaults updated (re-read from Meta after the write)

- object
  - `adAccountId` string
  - `dsaDefaults` object
    - `beneficiary` string
    - `payor` string

## Other responses

- `400` — Unsupported platform (non-Meta account) or invalid adAccountId
- `401` — Unauthorized
- `404` — Social account not found

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/f81ca70ea6b9/schema)