---
title: "Record action"
method: POST
path: "/v2/actions"
tags: ["Actions"]
---

# Record action

`POST /v2/actions`

Records a new action taken by a given partner or customer, and the number of times that action was performed.

## Request body

- object — **Actions** represent a specific action a partner or customer took on your platform
  - `created_at` integer — The created_at date of the action in epoch (ms).
  - `external_key` string, nullable — The external key of the action record in PartnerStack
  - `target_key` string, required — The identifier of the target specified in `target_type`. For a customer, this is the customer key. For a partnership, it is their partner key.
  - `target_type` 'partnership' | 'customer', required — Whether to record an action under a partnership or customer
  - `type` string, required — The type of action the partner or customer performed
  - `value` integer, required — The number of times the action was performed

## Response `200`

Records a new action taken by a given partner or customer, and the number of times that action was performed.

- object
  - `data` object, required — **Actions** represent a specific action a partner or customer took on your platform
    - `created_at` integer — The created_at date of the action in epoch (ms).
    - `key` string — A unique identifier used to reference the object
    - `updated_at` integer — Unix timestamp in milliseconds taken at time of last update
    - `external_key` string, nullable — The external key of the action record in PartnerStack
    - `target_key` string — The identifier of the target specified in `target_type`. For a customer, this is the customer key. For a partnership, it is their partner key.
    - `target_type` 'partnership' | 'customer' — Whether to record an action under a partnership or customer
    - `type` string — The type of action the partner or customer performed
    - `value` integer — The number of times the action was performed
  - `message` string, required
  - `status` integer, required

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `403` — Forbidden Error
- `404` — Not Found Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/partnerstack/apis/partnerstack-api.md) · [All operations](https://skmtc.dev/partnerstack/apis/partnerstack-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/partnerstack/partnerstack-api/revisions/0f35aebe53a9/schema)