Templates

List media plan templates

media_planner.templates.list

Lists the strategy templates a media plan can start from: a structure of campaigns (name + platform), without budgets or dates. source=own (default) returns this organization's templates in their order; source=available adds the workspace's (for an account, source: parent) and MB Suite's published system templates (source: system), which is what media_planner.plans.create accepts as template_id. Requires view access to the Media Planner.

Scope

media_planner:read

Permission

View the module

MCP tool

media_planner_templates_listOn the full surface; on the compact one, mb_execute_operation with id: "media_planner.templates.list".

Declared cost: up to 600 reads and 0 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

curl "https://api.mb-suite.com/v1/media-planner/templates" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/media-planner/templates" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Get one media plan template

media_planner.templates.get

Returns one of this organization's strategy templates: name, description, color, labels and its campaign structure (campaign_templates: name, platform, order), with the platforms it uses. Not found (media_plan_template_not_found) for a template of another organization or a system template (see media_planner.templates.list_system). Requires view access to the Media Planner.

Scope

media_planner:read

Permission

View the module

MCP tool

media_planner_templates_getOn the full surface; on the compact one, mb_execute_operation with id: "media_planner.templates.get".

Declared cost: up to 1 reads and 0 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

curl "https://api.mb-suite.com/v1/media-planner/templates/{template_id}" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/media-planner/templates/{template_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Create a media plan template

media_planner.templates.create

Creates a strategy template: name, optional description, color (#rrggbb, default #2563eb), label_ids and campaign_templates (up to 200: name, platform, platform_custom_name for 'other', order). It stores only the structure (no budgets or dates); a new plan in campaigns mode can start from it. Placed last. Returns the template. Requires full access to the Media Planner.

Scope

media_planner:write

Permission

Edit in the module

MCP tool

media_planner_templates_createOn the full surface; on the compact one, mb_execute_operation with id: "media_planner.templates.create".

Declared cost: up to 1 reads and 1 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

curl -X POST "https://api.mb-suite.com/v1/media-planner/templates" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME"
}'

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl -X POST "https://api.mb-suite.com/v1/media-planner/templates" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "name": "NAME"
}'

Update a media plan template

media_planner.templates.update

Updates a template of this organization, with the fields inside updates ({ template_id, updates: { … } }): name, description, color, label_ids and/or campaign_templates (the whole structure is replaced; the platforms and the campaign count are recomputed). Plans already created from it do not change. Returns the template. Requires full access to the Media Planner.

Scope

media_planner:write

Permission

Edit in the module

MCP tool

media_planner_templates_updateOn the full surface; on the compact one, mb_execute_operation with id: "media_planner.templates.update".

Declared cost: up to 1 reads and 1 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

curl -X PATCH "https://api.mb-suite.com/v1/media-planner/templates/{template_id}" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl -X PATCH "https://api.mb-suite.com/v1/media-planner/templates/{template_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Delete a media plan template

media_planner.templates.delete

Deletes a template of this organization (plans created from it do not change). It goes to the 30-day trash, where an owner or admin can restore it (platform.trash.restore). Outside the app it needs a dry run and a confirm_token, except a REST DELETE with a key allowed to delete. Requires full access to the Media Planner.

With an API key, this DELETE runs directly: the record stays 30 days in the trash and the response carries its trash_item_id. With an OAuth token, and through the MCP, it needs dry_run → confirm_token.

Scope

media_planner:write and “Allow deletions” (media_planner:delete in OAuth)

Permission

Edit in the module

MCP tool

media_planner_templates_deleteOn the full surface; on the compact one, mb_execute_operation with id: "media_planner.templates.delete".

Declared cost: up to 1 reads and 1 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

curl -X DELETE "https://api.mb-suite.com/v1/media-planner/templates/{template_id}" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl -X DELETE "https://api.mb-suite.com/v1/media-planner/templates/{template_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Duplicate a media plan template

media_planner.templates.duplicate

Copies a template of this organization as '<name> (Copia)', placed last, with the same structure, color and labels. Returns the new template. Requires full access to the Media Planner.

Scope

media_planner:write

Permission

Edit in the module

MCP tool

media_planner_templates_duplicateOn the full surface; on the compact one, mb_execute_operation with id: "media_planner.templates.duplicate".

Declared cost: up to 2 reads and 1 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

curl -X POST "https://api.mb-suite.com/v1/media-planner/templates/{template_id}/duplicate" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl -X POST "https://api.mb-suite.com/v1/media-planner/templates/{template_id}/duplicate" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Reorder media plan templates

media_planner.templates.reorder

Sets the order of this organization's templates: template_ids in the new order (position = index). All or nothing: an id that is not a template of this organization stops the whole reorder (404). Requires full access to the Media Planner.

Scope

media_planner:write

Permission

Edit in the module

MCP tool

media_planner_templates_reorderOn the full surface; on the compact one, mb_execute_operation with id: "media_planner.templates.reorder".

Declared cost: up to 200 reads and 200 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

curl -X POST "https://api.mb-suite.com/v1/media-planner/templates/reorder" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "template_ids": [
    "TEMPLATE_ID"
  ]
}'

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl -X POST "https://api.mb-suite.com/v1/media-planner/templates/reorder" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "template_ids": [
    "TEMPLATE_ID"
  ]
}'

List MB Suite's system templates

media_planner.templates.list_system

Lists MB Suite's published strategy templates (lead generation, e-commerce, awareness, B2B…), in their catalog order, with their campaign structure. Copy one into the organization with media_planner.templates.clone_system, or start a plan from it with template_id. Drafts are never listed. Requires view access to the Media Planner.

Scope

media_planner:read

Permission

View the module

MCP tool

media_planner_templates_list_systemOn the full surface; on the compact one, mb_execute_operation with id: "media_planner.templates.list_system".

Declared cost: up to 100 reads and 0 writes per call (they count against the daily quota).

Parameters

No parameters.

Response

Errors

Example

curl "https://api.mb-suite.com/v1/media-planner/system-templates" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/media-planner/system-templates" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Copy a system template into the organization

media_planner.templates.clone_system

Copies a published MB Suite system template into this organization's templates (placed last), where it can be edited like any other. Not found (system_media_plan_template_not_found) for a draft or unknown id. Returns the new template. Requires full access to the Media Planner.

Scope

media_planner:write

Permission

Edit in the module

MCP tool

media_planner_templates_clone_systemOn the full surface; on the compact one, mb_execute_operation with id: "media_planner.templates.clone_system".

Declared cost: up to 2 reads and 1 writes per call (they count against the daily quota).

Parameters

Response

Errors

Example

curl -X POST "https://api.mb-suite.com/v1/media-planner/system-templates/{system_template_id}/clone" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl -X POST "https://api.mb-suite.com/v1/media-planner/system-templates/{system_template_id}/clone" \
  -H "Authorization: Bearer $MB_TEST_KEY"