---
title: "POST /experimental/orgs/{orgId}/promotions/{campaignId}/activate"
method: POST
path: "/experimental/orgs/{orgId}/promotions/{campaignId}/activate"
tags: ["Orgs"]
---

# POST /experimental/orgs/{orgId}/promotions/{campaignId}/activate

`POST /experimental/orgs/{orgId}/promotions/{campaignId}/activate`

## Request

- Base URL: `https://api.tessl.io`
- URL: `https://api.tessl.io/experimental/orgs/{orgId}/promotions/{campaignId}/activate`
- Auth: none declared

Activates a promotion offer for this org on behalf of the signed-in user, who must be a member of the org and eligible for the offer. The org in the path receives what the offer grants. Once per user: each member may activate it once, for one of their orgs, and a second activation by the same user, in any org, grants nothing and returns `activated`. An activation by a colleague does not count against the user. Returns 404 for an unknown campaign, and 403 for a user who is not a member or not eligible, and for an API key.

## Path parameters

- `orgId` string, uuid, required
- `campaignId` string, required

## Headers

- `Authorization` string

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, required: The campaign id.
    - `type` 'promotion-offer', required
    - `attributes` object, required
      - `state` union, required: `available`: the user may activate the offer for this org. `activated`: the org already has it, activated by this user or a colleague.
        - 'available'
        - 'activated'
      - `credits` integer, required: Credits the offer grants.

## Other responses

- `401`: Unauthorized
- `403`: Default Response
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-10-29** `06d2142ed144`: 1 info
  - api operation id `activateOrgPromotion` was added
- **2026-10-26** `300404337cdc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/orgs/:orgId/promotions/:campaignId/activate/post.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) - [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tessl/apis/tessl-api/revisions/0d008f56f0c1?raw)