Request ad account change
Asks the Koast team for a change on an ad account an ad account request delivered: rename it, share it into another Business Manager, connect a pixel, a Facebook page or an Instagram account to it, or move it to a new domain.
Tool name: request-ad-account-change.
Asks the Koast team for a change on an ad account an ad account request delivered: rename it, share it into another Business Manager, connect a pixel, a Facebook page or an Instagram account to it, or move it to a new domain. The team makes the change and the user hears back by email and in Koast once it is done, or why it could not be done.
When to use
Use when the user wants to rename an ad account Koast's partner made, share it into another Business Manager, connect a pixel, page or Instagram account to it, or move it to a new domain. Confirm the ad account and the exact value first. A pixel, page or Instagram account must first be shared with Koast's Business Manager (assetBusinessManagerId on the request). A card change is made in the Koast app, not here. Follow it with list-ad-account-changes.
Access
| Property | Value |
|---|---|
| Required scope | write |
| Publishes | No |
| Read-only | No |
| Destructive | No |
| Idempotent | No |
| Open world | Yes |
Input
| Field | Type | Required | Description |
|---|---|---|---|
requestId | string | Yes | The ad account request id, or its Koast reference (KST-…). At most 40 characters. |
adAccountId | string | Yes | The ad account to change, act_…: one of the request's accounts. At most 40 characters. |
kind | string | Yes | What to change: rename (give name), share_business_manager (give businessManagerId and access), connect_pixel (give pixelId), connect_page (give pageUrl), connect_instagram (give instagram), change_domain (give domain). card is refused here: a card is added in the Koast app. One of rename, card, share_business_manager, connect_pixel, connect_page, connect_instagram, change_domain. |
name | string | No | For rename: the new ad account name. At most 100 characters. |
businessManagerId | string | No | For share_business_manager: the id of the Business Manager to share the ad account into. At most 40 characters. |
access | string | No | For share_business_manager: manage (full control) or advertise (create and run ads). One of manage, advertise. |
pixelId | string | No | For connect_pixel: the pixel (dataset) id. The pixel must first be shared with Koast's Business Manager, assetBusinessManagerId on the request. At most 40 characters. |
pageUrl | string | No | For connect_page: the Facebook page link. The page must first be shared with Koast's Business Manager. At most 500 characters. |
instagram | string | No | For connect_instagram: the Instagram handle or profile link. The account must first be shared with Koast's Business Manager. At most 100 characters. |
domain | string | No | For change_domain: the new domain the ads send people to, such as newdomain.com. At most 253 characters. |
note | string | No | Anything else the team should know, in the user's words. At most 1000 characters. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
change | object | Yes |
REST equivalent
POST /v1/ad-account-requests/{requestId}/accounts/{adAccountId}/changes, Request ad account change. CLI: koast request-ad-account-change.
Quote ad account funds
Prices adding funds to an ad account from an ad account request exactly as add-ad-account-funds would charge, without creating anything: the budget that lands on the ad account, Koast's fee, the platform location fee and the total the user pays.
Request ad account replacement
Asks for a new ad account to replace one Koast created that stopped running (Meta disabled or restricted it).