[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Update submission status

> Moves one submission to another status in your hiring workflow. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/bullhorn/update_submission_status

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Moves one submission to another status in your hiring workflow.

Bullhorn API: https://cotlet.dev/docs/api/bullhorn.md

`PATCH https://cotlet.dev/api/v1/bullhorn/submissions/{submission_id}/status`

Access: write. Confirm: waits for the user's OK before it runs.

Sets the status of one submission, like clicking the status on the job's Submissions tab. status must exist in your account's list, for example Sales Rep Rejected, Candidate Interested or Offer Extended. Changing a candidate that is not yours needs the Change Any Candidate Submission Status entitlement. It never deletes a submission and does not place a candidate. By default you confirm each call; you can switch that off for this tool.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `submission_id` | integer | yes | Submission ID from list_job_submissions. |
| `status` | string | yes | Status name as it appears in your account. |

## Request

**cURL**

```bash
curl -X PATCH https://cotlet.dev/api/v1/bullhorn/submissions/905512/status \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"Sales Rep Rejected"}'
```

**Python**

```python
result = client.call("bullhorn", "update_submission_status", {"submission_id":905512,"status":"Sales Rep Rejected"})
```

**Node.js**

```js
const result = await cotlet.call('bullhorn', 'update_submission_status', {"submission_id":905512,"status":"Sales Rep Rejected"});
```

**CLI**

```bash
cotlet call bullhorn update_submission_status --data '{"submission_id":905512,"status":"Sales Rep Rejected"}'
```

## Example response

```json
{
  "submission_id": 905512,
  "previous_status": "Submitted",
  "status": "Sales Rep Rejected"
}
```

Previous: [Submit candidates to a job](https://cotlet.dev/docs/api/bullhorn/add_submission.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.