---
search:
  tags:
    - Mutations
    - POST
seo:
  description: >-
    Available on: Meta Reference for the POST /mutations endpoint in the
    AdCrunch API.
sidebar:
  label: Start a mutation
  badge: POST
title: Start a mutation
type: openapi-operation
---
**Available on:** [![Meta](/providers/meta.svg)](https://docs.adcrunch.dev/connect/providers)

Starts a change on a live advertiser and answers immediately.

The change does **not** happen during this request. The answer carries a `workflowId`. Poll `GET /mutations/{id}` with it to find out how the change ended. A Mutation is durable, so the id stays valid across retries and restarts.

A request that is refused here starts nothing. A body that does not match, an advertiser that is not yours, and an advertiser connected without write access are all refused before a Mutation exists, so a failed call leaves no row in the history.

**This operation checks the credential first and the body second.** A missing or unusable credential answers `401` even when the body is wrong as well. A body that does not match then answers `400` with `error` of `invalid_request`, and `issues` names each field.

A create never starts delivery: a campaign, an ad set and an ad all arrive **paused**. This API also cannot delete, so `meta_set_status` with `ARCHIVED` is how an object is retired.

`POST /mutations`