Skip to main content
POST
/
tasks
Create a task
curl --request POST \
  --url https://api.chooseserene.com/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "submit_prior_authorization",
  "data": "<string>"
}
'
{
  "id": 1,
  "accountId": 1,
  "task_number": 1,
  "status": "pending",
  "handler": "submit_claim_1",
  "title": "Submit claim #1",
  "instructions": "SOP: Log in to portal, open claim form, enter member and procedure details, submit and capture confirmation number.",
  "startedAt": null,
  "completedAt": null,
  "failedAt": null,
  "notes": null,
  "createdAt": "2025-03-18T12:00:00.000Z",
  "updatedAt": "2025-03-18T12:00:00.000Z"
}
Send POST /tasks with a task type and either inline data or file uploads. Task types
ValueDescription
submit_prior_authorizationSubmit a prior authorization request
check_eligibilityCheck member eligibility
submit_claimSubmit a claim
submit_appealSubmit an appeal
Request body
  • JSON (Content-Type: application/json): type (required) and optional data (string) for inline text (e.g. member ID, patient details, dates).
  • Multipart (Content-Type: multipart/form-data): type (required) and optional files for uploaded documents.
The response returns the created task; the instructions field contains the SOP used for the task. When the task reaches a final state, you receive the outcome via webhook. Examples 
curl --request POST \
  --url "https://api.chooseserene.com/tasks" \
  --header "Authorization: Bearer <api-key>" \
  --header "Content-Type: application/json" \
  --data '{"type": "submit_claim", "data": "member_id: 300059049\npatient: Jane Doe\nDOB: 1990-01-15\nservice_date: 2025-03-20"}'

Body

​
type
enum<string>
required

Type of task: submit prior authorization, check eligibility, submit claim, or submit appeal

Available options:
submit_prior_authorization,
check_eligibility,
submit_claim,
submit_appeal
​
data
string

Task payload as text (e.g. member ID, patient details, dates). Use this or upload files via multipart/form-data.

Response

Created task

​
id
integer

Task ID

​
accountId
integer
​
task_number
integer
​
status
enum<string>
Available options:
pending,
dispatching,
running,
waiting_for_input,
pending_review,
completed,
completed_with_issues,
failed
​
handler
string
​
title
string
​
instructions
string
​
startedAt
string<date-time> | null
​
completedAt
string<date-time> | null
​
failedAt
string<date-time> | null
​
notes
string | null
​
createdAt
string<date-time>
​
updatedAt
string<date-time>