[#1505] Intake Form Field Not Populating via User API "book" Method

Migrated from Redmine #1505 | Author: Giuliano Helguero
Status: New | Priority: Immediate, there is BUG! | Created: 2025-12-08


Hi,
I’m using the User API to create bookings via the book method. The booking creates successfully, but the intake form field (Notes, ID 15) remains empty.

Questions:

What is the correct format for the additional parameter to populate intake form fields?
Should the field ID be a string “15” or integer 15?
Does the intake form field need a specific setting enabled to accept data via API?
Is there a different API method to set intake form values after booking creation (e.g., setAdditionalFields)?

Booking ID for reference: 43
Intake Field ID: 15 (textarea named “Notes”)
Thanks!

Here is my API call:
{
“jsonrpc”: “2.0”,
“method”: “book”,
“params”: [
8, // event_id
2, // unit_id
“2025-12-08”, // date
“12:30:00”, // time
{“name”:“John Doe",“email”:"john@test.com”,“phone”:“555-1234”}, // client
{“15”: “Order details text here…”}, // additional fields
1 // count
],
“id”: 1
}

Redmine Admin wrote:

hi, you need to use additional field id (looks like hash) to pass it in a book method. DO not use just name

Giuliano Helguero wrote:

Redmine Admin wrote in #note-1:

hi, you need to use additional field id (looks like hash) to pass it in a book method. DO not use just name

Redmine Admin wrote in #note-1:

hi, you need to use additional field id (looks like hash) to pass it in a book method. DO not use just name

Thank you for your prompt response, can you please specify a little more clear on what exactly to add? Right now I just have notes as my lone custom intake form.

Just reintegrate my problem, clients schedule via our website. Our custom intake forms are better suited than simply’s because of the logic we use. So, when they schedule their appointment; on simply’s side I need to see all their details in the notes section. Which isn’t happening right now, even though our code is fine.

Giuliano Helguero wrote:

Here is my website, and the service I am specifically talking about is “Apostilles Services”

Link: https://mdgnotaryca.com

Giuliano Helguero wrote:

Giuliano Helguero wrote in #note-3:

Here is my website, and the service I am specifically talking about is “Apostilles Services”

Link: https://mdgnotaryca.com

This intake form is only for apostilles services

Redmine Admin wrote:

here is a ticket with example Bug #1323: Intake form how i can pass value through API - API - Simplybook.me support for developers

Giuliano Helguero wrote:

Hi, sorry to ask probably an obvious question showever, What is the hash/unique field name for my Notes intake field (ID 15)? The getAdditionalFields API returns empty for my services. I need the hash string to pass in the additional parameter of the book method.

Giuliano Helguero wrote:

I’m using the JSON RPC API book method with the additional parameter. What is the exact field hash/name for my Notes intake field (ID 15)?
The page hash shows 1765281169542_k3qwrlranb_g05mzym but I need the field’s unique name/hash like the format shown in ticket #1323: 230b45ba58e5b4fc1a457e23a72531e2
My getAdditionalFields API call returns empty for my services, so I cannot retrieve it programmatically."

Redmine Admin wrote:

you need to get list of your intake forms by API request to get its ids. There is an example how to do it in ticket posted above: https://simplybook.me/en/api/developer-api/tab/rest_api#method_GET_/admin/additional-fields

Giuliano Helguero wrote:

Hi,
I’ve tried both formats from ticket #1323 but the Notes field (hash: c6e2ccfdfcb362ad980002f93ca79a87) still doesn’t save any data.
Format 1 - Map:
“params”: [8, 2, “2025-12-10”, “08:00:00”,
{“name":“Test”,“email”:"test@test.com”,“phone”:“555-1234”},
{“c6e2ccfdfcb362ad980002f93ca79a87”: “Test notes here”},
1
]
Format 2 - Array of objects:
json"params": [8, 2, “2025-12-10”, “08:45:00”,
{“name":“Test”,“email”:"test@test.com”,“phone”:“555-1234”},
[{“field”:“c6e2ccfdfcb362ad980002f93ca79a87”, “value”:“Test notes here”}],
1
]
Both return success with booking ID, but when I check the booking in SimplyBook, the Notes field is empty.
My Notes field settings:

ID: 15
Hash/name: c6e2ccfdfcb362ad980002f93ca79a87
Type: textarea
Services: 8, 24, 26, 27
Required: No

Questions:

Is there a specific setting on the intake field that needs to be enabled for API writes?
Can you check booking ID 52 to see if the intake data was received?
Is there a different API method I should use to set intake form values after booking creation?

Thank you!

Giuliano Helguero wrote:

I have a new respect for developers lol, spent days and I still can’t get this resolved

Giuliano Helguero wrote:

.

(Short original content)

Giuliano Helguero wrote:

?

(Short original content)

Val Komarov wrote:

Hello, $additional parameter must be passed in a key-value object format, i.e. for your case


[
8, 2, "2025-12-10", "08:45:00", {"name":"Test","email":"test@test.com","phone":"555-1234"},
{"c6e2ccfdfcb362ad980002f93ca79a87": "Test notes here"},
...
]

Giuliano Helguero wrote:

.

(Short original content)

Giuliano Helguero wrote:

Hello I;m sending exactly this format but the Notes field is still empty:
json{“c6e2ccfdfcb362ad980002f93ca79a87”: “==== APOSTILLE ORDER DETAILS ====\n\n Antigua and Barbuda…”}
Booking ID 52 was just created. Can you check why the intake form value isn’t being stored?"

Giuliano Helguero wrote:

??

(Short original content)

Giuliano Helguero wrote:

Hey there I know this is a tough situation, and it may be an obvious solution

Giuliano Helguero wrote:

do you guys offer php coding services for hire?