Create a Blueprint Step Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://apidocs.plannrcrm.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "PlannrCRM MCP server": {
    "url": "https://apidocs.plannrcrm.com/mcp"
  }
}
Close
POST /api/v1/automation-blueprints/{automationBlueprint_uuid}/blueprint-steps
Personal access token & O auth2

Path parameters

  • automationBlueprint_uuid string Required
application/json

Body

  • name string Required

    Name of the automation step

  • type string Required

    Must be a verified action type or a condition

  • configuration array Required

    Configuration options for this step, requirements depend on type

  • parent_step_uuid string

    Uuid of the step that run before this step, if the parent step is a condition type then a condition state must be given

  • condition_state boolean

    Only required if parent step is a condition, the condition state will determine if this step runs in the true branch or the false branch of the parent condition

Responses

  • 201 application/json
    Hide response attribute Show response attribute object
    • data array[object]
      Hide data attributes Show data attributes object
      • uuid string
      • created_at string
      • updated string
      • name string
      • type string
      • configuration object
        Hide configuration attribute Show configuration attribute object
        • params object
          Hide params attribute Show params attribute object
          • account_uuid object
            Hide account_uuid attributes Show account_uuid attributes object
            • type string
            • value string
      • condition_state boolean
      • parent_step_uuid string
  • 422 application/json

    Validation error

    Hide response attributes Show response attributes object
    • message string Required

      A human-readable description of the error.

    • errors object

      Validation messages keyed by the field that failed.

      Hide errors attribute Show errors attribute object
      • * array[string] Additional properties
POST /api/v1/automation-blueprints/{automationBlueprint_uuid}/blueprint-steps 
curl \
 --request POST 'https://api.plannrcrm.com/api/v1/automation-blueprints/6ff8f7f6-1eb3-3525-be4a-3932c805afed/blueprint-steps' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "name": "send an email",
  "type": "mail.send",
  "configuration": [
    {
      "params": {
        "account_uuid": {
          "type": "ref",
          "value": "trigger.account.uuid"
        }
      }
    }
  ],
  "parent_step_uuid": "string",
  "condition_state": true
}'
Request examples 
{
  "name": "send an email",
  "type": "mail.send",
  "configuration": [
    {
      "params": {
        "account_uuid": {
          "type": "ref",
          "value": "trigger.account.uuid"
        }
      }
    }
  ],
  "parent_step_uuid": "string",
  "condition_state": true
}
Response examples (201) 
{
  "data": [
    [
      {
        "uuid": "cb716145-2495-4332-bdd6-5e929679cbac",
        "created_at": "2026-09-18T09:00:12+01:00",
        "updated": "2026-09-18T09:00:12+01:00",
        "name": "create a new client",
        "type": "client.create",
        "configuration": {
          "params": {
            "account_uuid": {
              "type": "ref",
              "value": "trigger.account.uuid"
            }
          }
        },
        "condition_state": false,
        "parent_step_uuid": "8061aa78-bc80-4883-aeea-19e4d0280d19"
      }
    ]
  ]
}
Response examples (422) 
{
  "message": "The given data was invalid.",
  "errors": {
    "field": [
      "The field is invalid."
    ]
  }
}