---
title: "Report a conversion outcome"
method: POST
path: "/v1/companies/{company_id}/outcomes"
---

# Report a conversion outcome

`POST /v1/companies/{company_id}/outcomes`

## Request

- Base URL: `https://api.reqbeat.com`
- URL: `https://api.reqbeat.com/v1/companies/{company_id}/outcomes`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Write back a conversion outcome for `company_id`. Appends to the
caller's own outcome labels, which are retention-protected.

Requires the `write` scope.

## Path parameters

- `company_id` integer, required: The plane's company id -- returned as `company_id` by /v1/reqs/search and by every company motion response.

## Request body

- WriteOutcomeRequest
  - `req_key` string, nullable
  - `outcome` string, required
  - `observed_at` string, date-time, required

## Response `202`

Successful Response

- WriteOutcomeResponse
  - `id` integer, required

## Other responses

- `401`: No API key was sent.
- `403`: The presented key is invalid or revoked, or (see `x-required-scope` on this operation) it does not carry the scope this operation requires.
- `422`: Validation Error

---

[API](https://skmtc.dev/reqbeat/apis/reqbeat-api.md) · [All operations](https://skmtc.dev/reqbeat/apis/reqbeat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reqbeat/apis/reqbeat-api/revisions/4758e5957e8c?raw)