Skip to content
Pitch2SaleDevelopers
Open the app
Early access: these pages are being written and reviewed. Facts in the header boxes come straight from the product.

Simulate a workflow with an existing or sample lead

POST
/api/v1/workflows/{id}/simulate
curl --request POST \
--url https://api.pitch2sale.com/api/v1/workflows/example/simulate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "lead_id": "example", "fixture": { "name": "example", "email": "hello@example.com", "status": "example", "custom_fields": { "additionalProperty": "example" } } }'

Pass a lead_id or a sample lead (name, email, status, custom fields); nothing is sent or changed.

id
required
string
Media typeapplication/json
object
lead_id
string
/^[0-9a-fA-F]{24}$/
fixture
object
name
required
string
>= 1 characters <= 200 characters
email
required
string format: email
status
string
<= 100 characters
custom_fields
object
key
additional properties
Examplegenerated
{
"lead_id": "example",
"fixture": {
"name": "example",
"email": "hello@example.com",
"status": "example",
"custom_fields": {
"additionalProperty": "example"
}
}
}

OK

Validation failed

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Authentication required or token invalid

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Role permission or token scope missing

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Rate limit exceeded

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}