---
title: "act: place participant"
description: "Places one party in one role on one stock of a vertical's chain, with the evidence for it to The answer gives the participant, ready or not ready with the reason"
section: reference
address: /reference/act/place_participant
contract: 0476e35e6e275db5
---
# act: place participant
Places one party in one role on one stock of a vertical's chain, with the evidence for it to The answer gives the participant, ready or not ready with the reason
[figure: The caller sends PlaceParticipantInput to /v1/act/place_participant. The platform returns a card whose body is MarketParticipant.]
POST/v1/act/place_participant
Place a participant. The call needs the brand rung under a token with the act grant, and it is served by the platform.
The route takes [PlaceParticipantInput](/concepts/placeparticipantinput) and returns a card whose body is [MarketParticipant](/concepts/marketparticipant).
## Request body
The request body is [PlaceParticipantInput](/concepts/placeparticipantinput).
| field | type | required | note |
|---|---|---|---|
| `vertical` | `id` | yes | |
| `segment` | `id` | no | |
| `stock` | `text` | yes | |
| `party` | `id` | yes | |
| `party_kind` | `one of company \| brand \| person \| account \| community \| organisation` | yes | |
| `role` | [RoleAroundADecision](/concepts/rolearoundadecision) | yes | |
| `side` | `one of demand \| supply \| intermediary \| influence \| rules` | yes | |
| `impact_on` | [ParticipantImpact](/concepts/participantimpact) | no | |
| `evidence` | [EvidenceRef](/concepts/evidenceref) | yes | |
## Response
The route returns a card whose body is [MarketParticipant](/concepts/marketparticipant). Every card ends with a foot that states the basis of each number, the scope of the call, and the time when the facts were true.
## Headers
| header | required | meaning |
|---|---|---|
| `Scale-Scope` | yes | the scope the call runs in: tenant/, then /brand/, then /strategy/ |
| `Scale-As-True-On` | no | the date the facts must have been true on; defaults to now |
| `Scale-As-Known-On` | no | the date the facts must have been known on; defaults to now |
| `Scale-Key` | no | for a change, the key made from the input; a repeat under the same key returns the unit held and writes nothing |
A caller needs the brand rung and a token with the act grant. The platform serves this route.
## Example
The example sends the smallest body that PlaceParticipantInput allows. The build validates it against the schema of PlaceParticipantInput.
Example
```sh
curl -X POST https://api.scaleintelligence.co/v1/act/place_participant \
-H "Scale-Key: $SCALE_KEY" -H "Scale-Scope: tenant/" \
-H "content-type: application/json" \
-d '{ "vertical": "…", "stock": "…", "party": "…", "party_kind": "company", "role": "…", "side": "demand", "evidence": [] }'
```
```typescript
import { client } from "@scale/sdk";
const answer = await client.act.place_participant({
"vertical": "…",
"stock": "…",
"party": "…",
"party_kind": "company",
"role": "…",
"side": "demand",
"evidence": []
});
// answer.body is a MarketParticipant. answer.foot holds the basis, the scope and the time.
```
```python
import requests
answer = requests.post("https://api.scaleintelligence.co/v1/act/place_participant",
headers={"Scale-Key": KEY, "Scale-Scope": "tenant/"},
json={
"vertical": "…",
"stock": "…",
"party": "…",
"party_kind": "company",
"role": "…",
"side": "demand",
"evidence": []
}).json()
```
```rust
let answer: Card = client.post("https://api.scaleintelligence.co/v1/act/place_participant")
.header("Scale-Key", key).header("Scale-Scope", "tenant/")
.json(&PlaceParticipantInput { /* the fields of the page */ }).send().await?.json().await?;
```