Paddle Billing
Search

Create a simulation

posthttps://api.paddle.com/simulations

Creates a new simulation for a notification setting (notification destination).

If successful, your response includes a copy of the new simulation entity.

Request Body

namestringrequired

Name of this simulation.

notification_setting_idstringrequired

Paddle ID of the notification setting where this simulation is sent, prefixed with ntfset_.

typestringrequired

Single event sent for this simulation, in the format entity.event_type.

payloadobject or null

Simulation payload. Pass a JSON object that matches the schema for an event type to simulate a custom payload. If omitted, Paddle populates with a demo example.

Response

dataobject

Represents a simulation entity.

idstring

Unique Paddle ID for this simulation, prefixed with ntfsim_.

statusstring

Whether this entity can be used in Paddle.

notification_setting_idstring

Paddle ID of the notification setting where this simulation is sent, prefixed with ntfset_.

namestring

Name of this simulation.

typestring

Single event sent for this simulation, in the format entity.event_type.

payloadobject or null

Simulation payload.

last_run_atstring<date-time> or null

RFC 3339 datetime string of when this simulation was last run. null until run. Set automatically by Paddle.

created_atstring<date-time>

RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.

updated_atstring<date-time>

RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.

metaobject

Information about this response.

request_idstring

Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.