Create job
Create a job for an account in a pipeline, with stage, assignee, priority and due date.
POST https://cotlet.dev/api/v1/taxdome/accounts/{account_id}/jobs
write
Creates a job for one account in a pipeline, optionally from a template so its tasks come with it. It reaches no client, so it does not ask for confirmation; archive_job undoes it in one call.
Parameters
| Name | Type | Description |
|---|---|---|
| account_id string required | string | Account ID from list_accounts. |
| pipeline_id string required | string | Pipeline ID from list_pipelines. |
| stage string | string | Stage name. Default: the first stage. |
| template string | string | Job template name from list_pipelines. |
| assignee string | string | Team member name. |
| priority string | string | 'Low', 'Medium', 'High' or 'Urgent'. |
| due_date date | date | Due date, ISO. |
Request
curl -X POST https://cotlet.dev/api/v1/taxdome/accounts/acc_4f21/jobs \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"pipeline_id":"pl_annual","stage":"Intake","assignee":"Maria Silva","priority":"Medium","due_date":"2027-03-15"}'result = client.call("taxdome", "create_job", {"account_id":"acc_4f21","pipeline_id":"pl_annual","stage":"Intake","assignee":"Maria Silva","priority":"Medium","due_date":"2027-03-15"})const result = await cotlet.call('taxdome', 'create_job', {"account_id":"acc_4f21","pipeline_id":"pl_annual","stage":"Intake","assignee":"Maria Silva","priority":"Medium","due_date":"2027-03-15"});cotlet call taxdome create_job --data '{"account_id":"acc_4f21","pipeline_id":"pl_annual","stage":"Intake","assignee":"Maria Silva","priority":"Medium","due_date":"2027-03-15"}'Example response
{
"job_id": "job_3190",
"name": "Annual Filing 2026",
"account_id": "acc_4f21",
"pipeline": "Annual Filing",
"stage": "Intake",
"assignee": "Maria Silva",
"priority": "Medium",
"due_date": "2027-03-15"
}