---
title: "Changes to Invoke an Ad Hoc Automation"
method: POST
path: "/automations/invoke"
---

# Changes to Invoke an Ad Hoc Automation

`POST /automations/invoke`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 55 revisions.

- **2026-07-29** `f76bed79a913`: 2 info
- **2025-10-07** `7143ea51f307`: 7 breaking, 13 warning, 14 info

## Changes

- **2026-07-29** `f76bed79a913`: 2 info
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional `header` request parameter `x-idempotency-expiration`
- **2025-10-07** `7143ea51f307`: 7 breaking, 13 warning, 14 info
  - the request property `automation/steps/items/oneOf[subschema #4: AutomationCancelStep -> subschema #5: AutomationCancelStep]/cancelation_token` became not nullable
  - the request property `automation/steps/items/oneOf[subschema #4: AutomationCancelStep -> subschema #5: AutomationCancelStep]/cancelation_token` became required
  - removed the enum value `none` of the request property `automation/steps/items/oneOf[subschema #6: AutomationFetchDataStep]/merge_strategy`
  - removed `#/components/schemas/AutomationAddToDigestStep, #/components/schemas/AutomationAddToBatchStep, #/components/schemas/AutomationThrottleStep, #/components/schemas/AutomationV2SendStep` from the `automation/steps/items/` request property `oneOf` list
  - the `automation/steps/items/oneOf[subschema #11: AutomationUpdateProfileStep -> subschema #4: AutomationUpdateProfileStep]/profile` request property type changed from no type to `object`
  - the `automation/steps/items/oneOf[subschema #6: AutomationFetchDataStep]/webhook/body` request property type changed from `object` to `string`
  - the `automation/steps/items/oneOf[subschema #8: AutomationSendStep -> subschema #2: AutomationSendStep]/profile` request property type changed from no type to `object`
  - removed `#/components/schemas/AutomationInvokeParams` from the request body `allOf` list
  - removed `#/components/schemas/AutomationStep` from the `automation/steps/items/oneOf[subschema #10: AutomationSendListStep -> subschema #3: AutomationSendListStep]/` request property `allOf` list
  - removed `#/components/schemas/AutomationStep` from the `automation/steps/items/oneOf[subschema #4: AutomationCancelStep -> subschema #5: AutomationCancelStep]/` request property `allOf` list
  - removed `#/components/schemas/AutomationStep` from the `automation/steps/items/oneOf[subschema #5: AutomationDelayStep -> subschema #1: AutomationDelayStep]/` request property `allOf` list
  - removed `#/components/schemas/AutomationStep` from the `automation/steps/items/oneOf[subschema #6: AutomationFetchDataStep]/` request property `allOf` list
  - removed `#/components/schemas/AutomationStep` from the `automation/steps/items/oneOf[subschema #7: AutomationInvokeStep]/` request property `allOf` list
  - removed `#/components/schemas/AutomationStep` from the `automation/steps/items/oneOf[subschema #8: AutomationSendStep -> subschema #2: AutomationSendStep]/` request property `allOf` list
  - removed the request property `automation/steps/items/oneOf[subschema #10: AutomationSendListStep -> subschema #3: AutomationSendListStep]/override`
  - removed the request property `automation/steps/items/oneOf[subschema #10: AutomationSendListStep -> subschema #3: AutomationSendListStep]/template`
  - removed the request property `automation/steps/items/oneOf[subschema #6: AutomationFetchDataStep]/idempotency_expiry`
  - removed the request property `automation/steps/items/oneOf[subschema #6: AutomationFetchDataStep]/idempotency_key`
  - removed the request property `automation/steps/items/oneOf[subschema #6: AutomationFetchDataStep]/webhook/params`
  - removed the request property `automation/steps/items/oneOf[subschema #8: AutomationSendStep -> subschema #2: AutomationSendStep]/override`
  - added the new optional request property `brand`
  - added the new optional request property `data`
  - added the new optional request property `profile`
  - added the new optional request property `recipient`
  - added the new optional request property `template`
  - the request property `automation/steps/items/oneOf[subschema #11: AutomationUpdateProfileStep -> subschema #4: AutomationUpdateProfileStep]/merge` became nullable
  - the request property `automation/steps/items/oneOf[subschema #11: AutomationUpdateProfileStep -> subschema #4: AutomationUpdateProfileStep]/recipient_id` became nullable
  - the request property `automation/steps/items/oneOf[subschema #6: AutomationFetchDataStep]/merge_strategy` became nullable
  - the request property `automation/steps/items/oneOf[subschema #11: AutomationUpdateProfileStep -> subschema #4: AutomationUpdateProfileStep]/merge` became optional
  - the request property `automation/steps/items/oneOf[subschema #11: AutomationUpdateProfileStep -> subschema #4: AutomationUpdateProfileStep]/recipient_id` became optional
  - the request property `automation/steps/items/oneOf[subschema #6: AutomationFetchDataStep]/merge_strategy` became optional
  - added the new `DELETE` enum value to the request property `automation/steps/items/oneOf[subschema #6: AutomationFetchDataStep]/webhook/method`
  - added the new `PATCH` enum value to the request property `automation/steps/items/oneOf[subschema #6: AutomationFetchDataStep]/webhook/method`
  - added the new `PUT` enum value to the request property `automation/steps/items/oneOf[subschema #6: AutomationFetchDataStep]/webhook/method`

---

[Operation](https://skmtc.dev/trycourier/apis/courier/docs/automations/invoke/post.md) - [API](https://skmtc.dev/trycourier/apis/courier.md) - [Page](https://skmtc.dev/trycourier/apis/courier/changes/automations/invoke/post)