Approvals

Submit a request

Adds an entry to the list and sends it for approval (same as Send for approval on the web). Leave working days exclude public holidays; if you are the approver it is approved directly. item in the response is the new request.

POST/api/v1/approvals/forms/{list_id}

Authorization

Authorizationheaderrequired

Bearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).

Scope: crm.write

Path parameters

list_idintegerrequired

Form (list) id.

Body application/json

valuesobjectrequired

Field key → value (date YYYY-MM-DD, person user id, checkbox true).

notestringoptional

Note to the approver.

Errors

HTTP	error	Meaning
`400`	`invalid`	Missing or invalid field (`message` explains).
`404`	`not_found`	Record not found.

Request

curl -X POST https://ornek.solk.app/api/v1/approvals/forms/{list_id} \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/approvals/forms/{list_id}", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

r = requests.post(
    "https://ornek.solk.app/api/v1/approvals/forms/{list_id}",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())

Response