SynqDocs
Management APIBrand transfers

Email a moved brand's users

Once a brand moved to this org, its owner has Synq tell the brand's users: who runs it now and is responsible for their data, that nothing changes for them, and the brand's privacy policy, from the brand's own sender, to each user with a verified address who may use their account and whom Synq may email. Once: asking again answers the same and sends nothing more. It goes out in the background, in batches within the notice's own mail budget, so the brand's sign-in codes never wait on it; the request's `notice` says when the last went and how many it reached. It can be asked for while the request is kept, 30 days after the move. Needs `org.brands.transfer`. Only an owner of the org, as a person, signed in within the last 5 minutes: an API key never asks, decides or cancels a move. A person needs a sign-in at Synq from the last 5 minutes whose time Synq proved (send them to sign in with `max_age=300`), else 403 `fresh_sign_in_required`; an API key never does. A request that wasn't accepted, or whose brand isn't this org's any more, is `conflict` (409). Recorded as `brand.transfer_notice_sent` in this org's log once the last goes, also its webhooks' event.

POST/v1/orgs/{org}/brand-transfers/{transfer}/notice

Once a brand moved to this org, its owner has Synq tell the brand's users: who runs it now and is responsible for their data, that nothing changes for them, and the brand's privacy policy, from the brand's own sender, to each user with a verified address who may use their account and whom Synq may email. Once: asking again answers the same and sends nothing more. It goes out in the background, in batches within the notice's own mail budget, so the brand's sign-in codes never wait on it; the request's notice says when the last went and how many it reached. It can be asked for while the request is kept, 30 days after the move. Needs org.brands.transfer. Only an owner of the org, as a person, signed in within the last 5 minutes: an API key never asks, decides or cancels a move. A person needs a sign-in at Synq from the last 5 minutes whose time Synq proved (send them to sign in with max_age=300), else 403 fresh_sign_in_required; an API key never does. A request that wasn't accepted, or whose brand isn't this org's any more, is conflict (409). Recorded as brand.transfer_notice_sent in this org's log once the last goes, also its webhooks' event.

Authorization

bearer
AuthorizationBearer <token>

An org API key (sk_live_…, sk_test_…), or an access token from the Synq issuer (the synq brand, on the accounts host) for this API.

In: header

Path Parameters

org*string

The org's id

Match^org_[0-9a-hjkmnp-tv-z]{26}$
transfer*string

The request's id

Match^btr_[0-9a-hjkmnp-tv-z]{26}$

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/brand-transfers/btr_01h455vb4pex5vsknk084sn02q/notice" \  -H "Authorization: Bearer $SYNQ_API_KEY"
{  "id": "string",  "brand": {    "id": "string",    "name": "Acme"  },  "from_org": {    "id": "string",    "name": "Acme"  },  "to_org": {    "id": "string",    "name": "Acme"  },  "direction": "outgoing",  "status": "pending",  "requested_by": "string",  "requested_at": "2026-10-21T12:00:00.000Z",  "expires_at": "2026-10-21T12:00:00.000Z",  "decided_at": "2026-10-21T12:00:00.000Z",  "cancelled_by": "from",  "new_default_brand_id": "string",  "close_from_org": true,  "data_responsibility_statement": "string",  "preview": {    "users": 0,    "monthly_active_users": 0,    "apps": [      {        "client_id": "app_01h455vb4pex5vsknk084sn02q",        "name": "Acme"      }    ],    "apps_total": 0,    "issuer": "string",    "custom_domains": [      "acme.example"    ],    "sending_domain": "acme.example",    "sending_domains": [      "mail.acme.com"    ],    "discord_servers": [      {        "id": "string",        "name": "Acme"      }    ],    "telegram_groups": [      {        "id": "string",        "title": "string"      }    ],    "own_bots": [      {        "id": "string",        "platform": "discord",        "name": "Acme"      }    ],    "sign_in_providers": [      {        "provider": "google",        "app_now": "brand",        "app_after": "brand"      }    ],    "stays_as_set": {      "terms_of_service_url": "https://app.acme.example",      "privacy_policy_url": "https://app.acme.example"    },    "blockers": [      {        "reason": "transfer_pending",        "detail": "string"      }    ],    "roles_ending": {      "members": 0,      "invitations": 0    },    "plan_changes": [      {        "feature": "string",        "effect": "string"      }    ],    "apps_over_quota": {      "apps": 0,      "limit": 0    }  },  "preview_hash": "string",  "reason": "string",  "from_org_empty": true,  "notice": {    "requested_at": "2026-10-21T12:00:00.000Z",    "sent_at": "2026-10-21T12:00:00.000Z",    "recipients": 0  }}