Skip to content

Postman walkthrough for the bootstrap POST

Concrete walkthrough of issuing the bootstrap POST from Postman. The same configuration applies to Insomnia, curl, or Make’s HTTP module — only the UI changes.

The high-level concept is in the Ingress webhook bootstrap article. Read that first; this article is the click-by-click version.

  • Method: POST
  • URL: paste the Ingress URL from the pool’s settings page

In the Authorization tab:

  • Type: API Key
  • Key: x-rocketlead-ingress-token — exact name from the API schema (header names are case-insensitive on the wire)
  • Value: paste the Ingress token from the pool’s settings
  • Add to: Header

This adds an x-rocketlead-ingress-token: <token> header to the outgoing request. You can also configure this manually in the Headers tab — same result.

In the Body tab:

  • Type: raw
  • Format: JSON

The body has two top-level keys: data (Tabellenschema fields, keyed by string key) and customFieldData (Custom Field values, keyed by UUID; optional).

Paste the bootstrap payload — for first-time setup, only data is populated:

{
"data": {
"firstName": "Test",
"lastName": "Lead",
"childFirstName": "Kid"
}
}

Keys you’ve not used before are auto-created on the pool as Tabellenschema fields. After bootstrap, you’ll convert generic fields like email and phone to Custom Fields and post subsequent payloads using their UUIDs in customFieldData.

Hit Send. A successful response returns 200 OK with the created lead’s full record:

{
"id": "<lead-uuid>",
"tableId": "<pool-uuid>",
"leadStateId": "<default-state-id>",
"data": {
"firstName": "Test",
"lastName": "Lead",
"childFirstName": "Kid"
},
"customFieldData": {
"<email-field-uuid>": "test@example.com",
"<phone-field-uuid>": "+4915112345678"
},
"createdAt": "...",
"updatedAt": "..."
}

The data object holds Tabellenschema fields keyed by their string keys. The customFieldData object holds Custom Field values keyed by UUID — that’s why automations reference these via the UUID and not the name.

Open the pool in the console and reload the page (the column list is browser-cached for ~5 minutes after the POST). The new lead is in the table; the new fields appear as columns with their raw keys as labels. Now you can:

  • Rename the labels via the pool’s field settings.
  • Assign types (firstName, lastName, email, phone, etc.).
  • Move generic fields like email and phone to global Custom Fields so they’re available across all pools.
Terminal window
curl -X POST "<ingress-url>" \
-H "Content-Type: application/json" \
-H "x-rocketlead-ingress-token: <token>" \
-d '{
"data": {
"firstName": "Test",
"lastName": "Lead"
}
}'

Same result, no GUI.

You’re done with schema setup. Continue to the Scheduling mental model — the densest topic in the handbook.