MCP tools

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

PropertyValue
Required scopewrite
PublishesNo
Read-onlyNo
DestructiveNo
IdempotentNo
Open worldYes

Input

FieldTypeRequiredDescription
requestIdstringYesThe ad account request id, or its Koast reference (KST-…). At most 40 characters.
adAccountIdstringYesThe ad account to change, act_…: one of the request's accounts. At most 40 characters.
kindstringYesWhat 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.
namestringNoFor rename: the new ad account name. At most 100 characters.
businessManagerIdstringNoFor share_business_manager: the id of the Business Manager to share the ad account into. At most 40 characters.
accessstringNoFor share_business_manager: manage (full control) or advertise (create and run ads). One of manage, advertise.
pixelIdstringNoFor 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.
pageUrlstringNoFor connect_page: the Facebook page link. The page must first be shared with Koast's Business Manager. At most 500 characters.
instagramstringNoFor connect_instagram: the Instagram handle or profile link. The account must first be shared with Koast's Business Manager. At most 100 characters.
domainstringNoFor change_domain: the new domain the ads send people to, such as newdomain.com. At most 253 characters.
notestringNoAnything else the team should know, in the user's words. At most 1000 characters.

Output

FieldTypeRequiredDescription
changeobjectYes

REST equivalent

POST /v1/ad-account-requests/{requestId}/accounts/{adAccountId}/changes, Request ad account change. CLI: koast request-ad-account-change.

On this page