requests.submitForm

Send a shop a request through its public form. No sign-in; needs the form key.


Who	Agents can call this
REST	`POST /v1/requests/submit`
MCP tool	`requests_submitForm`
Writes	yes, send an Idempotency-Key
Area	Customer hub, requests and customer emails

When to use it

Send a shop a request through its public form. No sign-in; needs the form key.

What to tell the owner

Say what you did in plain words and what happens next.

Input

Field	Type	Required
`form_key`	string	yes
`title`	string	yes
`details`	string	no
`name`	string	yes
`email`	string	no
`phone`	string	no
`address`	object	no
`address.line1`	string	yes
`address.line2`	string	no
`address.locality`	string	yes
`address.postal_code`	string	yes
`address.jurisdiction`	string	yes
`preferred_times`	string	no

Example

POST https://doingwork.work/v1/requests/submit
content-type: application/json
Idempotency-Key: 3f1c...

{
  "form_key": "...",
  "title": "...",
  "name": "Ruiz Plumbing"
}

Output

JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are {code, message, status}.

Errors

Code	Status	What to do
`invalid_input`, `invalid_token`, `rate_limited`		Can happen on any call. See errors.