> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Kør et bounty-program

> Slå betalte bounties op via API'et, finansiér depotet fra en kontosaldo, planlæg gentagelser, modtag og gennemgå indsendelser, og annullér bounties.

Slå betalte opgaver op fra dit eget produkt, finansiér dem fra en kontos saldo, og træk indsendelseskøen ind i din egen brugerflade. Denne guide dækker hele forløbet: oprettelse af en bounty, modtagelse af arbejde, gennemgang af det og annullering.

> [!NOTE]
>
> Du skal bruge en API-nøgle med `bounty:create` og `payout:transfer_funds`, fordi oprettelse af en bounty flytter penge. Læsning af indsendelser kræver `bounty:basic:read`.

## Slå en bounty op

[`POST /bounties`](https://docs.whop.com/da/api-reference/bounties/create-bounty) kræver en `title`, en `description` med de instruktioner, en udfører følger, og et `gross_reward_amount`.

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: process.env.WHOP_API_KEY });

const bounty = await client.bounties.create({
	title: "Clip our launch stream",
	description: "Cut a 30 to 60 second vertical clip and post it to TikTok. Include the product name in the caption.",
	gross_reward_amount: 25,
	accepted_submissions_limit: 4,
	business_goal_type: "clipping",
	account_id: "biz_XXXXXXXX",
	allowed_country_codes: ["US", "CA"],
});

console.log(bounty.id);
```

```python Python theme={null}
import os
from whop_sdk import Whop

client = Whop(token=os.environ["WHOP_API_KEY"])

bounty = client.bounties.create(
    title="Clip our launch stream",
    description="Cut a 30 to 60 second vertical clip and post it to TikTok. Include the product name in the caption.",
    gross_reward_amount=25,
    accepted_submissions_limit=4,
    business_goal_type="clipping",
    account_id="biz_XXXXXXXX",
    allowed_country_codes=["US", "CA"],
)

print(bounty.id)
```

### Hvad belønningen koster dig

`gross_reward_amount` er hele amerikanske dollars **pr. accepteret indsendelse**, ikke pr. bounty. `accepted_submissions_limit` angiver, hvor mange indsendelser der kan vinde, og er som standard `1`. Whop deponerer de to ganget sammen, og den total skal være mindst $5. Eksemplet ovenfor deponerer $100.

Platformgebyrer og affiliate-andele trækkes fra bruttobeløbet i stedet for at blive lagt oveni, så en belønning på $25 koster finansieringskilden $25.

### Hvor pengene kommer fra

Puljen trækker som standard på kalderens personlige saldo. Angiv `account_id` for i stedet at finansiere den fra en kontos saldo, hvilket kræver tilladelse til at flytte den kontos midler.

### Hvor bountyen befinder sig

`experience_id` placerer en bounty i en bestemt experience, offentlig for en åben bounty eller privat for en inviteret, og **den er påkrævet, medmindre du angiver `account_id`**. Når du angiver `account_id` og udelader experiencen, forankres bountyen i den kontos offentlige forum.

### Angivelse af målet

`business_goal_type` angiver, hvad arbejdet skal opnå, og du angiver det én gang, når du opretter bountyen. Det tager `clipping`, `post_engagement`, `owned_account_growth`, `ugc_content`, `local_activation`, `data_capture` eller `other`.

`capture_spec` accepteres kun, når målet er `data_capture`. Hvis det sendes med et andet mål, mislykkes anmodningen.

## Planlæg og gentag

En bounty udgives, så snart du opretter den, medmindre du angiver `publish_at`. Whop opretter den som en skjult kladde og finansierer og udgiver den derefter på det tidspunkt, du har angivet. `publish_at_timezone` er påkrævet, når `publish_at` er angivet.

`frequency` gør en planlagt bounty til en tilbagevendende. Den er som standard `once`, tager `hourly`, `daily`, `weekly` eller `monthly` og **gælder kun sammen med `publish_at`**. Hver forekomst er en separat bounty med sine egne indsendelser og sit eget depot.

```typescript TypeScript theme={null}
const weekly = await client.bounties.create({
	title: "Weekly product clip",
	description: "One vertical clip per week featuring a different product from the catalog.",
	gross_reward_amount: 50,
	account_id: "biz_XXXXXXXX",
	business_goal_type: "clipping",
	publish_at: "2026-09-01T15:00:00Z",
	publish_at_timezone: "America/New_York",
	frequency: "weekly",
});
```

```python Python theme={null}
weekly = client.bounties.create(
    title="Weekly product clip",
    description="One vertical clip per week featuring a different product from the catalog.",
    gross_reward_amount=50,
    account_id="biz_XXXXXXXX",
    business_goal_type="clipping",
    publish_at="2026-09-01T15:00:00Z",
    publish_at_timezone="America/New_York",
    frequency="weekly",
)
```

## Redigér en bounty

Hvad [`PATCH /bounties/{id}`](https://docs.whop.com/da/api-reference/bounties/update-bounty) accepterer, afhænger af, om bountyen er udgivet. En **planlagt kladde** accepterer alt: belønningen, vinderpladserne, tidsplanen og indholdsfelterne.

En **udgivet bounty** accepterer kun indhold, dvs. `title`, `description`, `allowed_country_codes` og `business_goal_type`. Selv de afvises, når bountyen holder op med at acceptere forsøg, eller når en indsendelse når `submitted` eller `approved`. Belønningen, vinderpladserne og tidsplanen ligger alle fast, når en bounty er udgivet.

`accepted_submissions_per_user_limit` begrænser, hvor mange pladser én udfører kan vinde. Den er som standard `1`, kan ikke overstige `accepted_submissions_limit`, og en udfører kører ét forsøg ad gangen.

## Modtag indsendelser

[`POST /bounty_submissions`](https://docs.whop.com/da/api-reference/bounty-submissions/create-bounty-submission) tager `bounty_id` og en `deliverable`. Kombinér `urls`, `file_ids` og en `caption`, med **mindst ét link eller én fil**. Whop afviser en tom leverance. På en almindelig bounty er dette ene kald hele udførerens forløb, og indsendelsen går direkte til gennemgang. Indsendelser kræver en brugerlegitimation, så en konto-API-nøgle kan ikke oprette en.

```typescript TypeScript theme={null}
const submission = await client.bountySubmissions.create({
	bounty_id: "bnty_XXXXXXXX",
	deliverable: {
		urls: ["https://www.tiktok.com/@creator/video/1234567890"],
		file_ids: ["file_XXXXXXXX"],
		caption: "Vertical cut, 42 seconds.",
	},
});
```

```python Python theme={null}
submission = client.bounty_submissions.create(
    bounty_id="bnty_XXXXXXXX",
    deliverable={
        "urls": ["https://www.tiktok.com/@creator/video/1234567890"],
        "file_ids": ["file_XXXXXXXX"],
        "caption": "Vertical cut, 42 seconds.",
    },
)
```

`allowed_country_codes` begrænser, hvem der kan udføre en bounty. Det tager ISO 3166 alpha-2-koder. En tom liste betyder hele verden.

En udfører kan trække sit eget forsøg tilbage med [`DELETE /bounty_submissions/{id}`](https://docs.whop.com/da/api-reference/bounty-submissions/cancel-bounty-submission). Kun den udfører, der startede det, kan gøre det, og en konto-API-nøgle kan ikke gøre det for vedkommende.

### Mål, din integration ikke kan fuldføre

To måltyper samler deres dokumentation uden for API'et. På en `data_capture`-bounty skal du oprette indsendelsen **uden** en leverance: det starter et påtaget forsøg, hvis klip samles på serversiden. Dokumentation for en livestream-bounty kører gennem en flade, som det offentlige API ikke eksponerer. Din integration kan slå disse bounties op og læse deres køer, men en udfører afslutter forsøget i Whop.

## Gennemgå køen

Læs indsendelser med [`GET /bounty_submissions`](https://docs.whop.com/da/api-reference/bounty-submissions/list-bounty-submissions), filtreret efter `bounty_id` og eventuelt efter `status`.

```typescript TypeScript theme={null}
const queue = await client.bountySubmissions.list({
	bounty_id: "bnty_XXXXXXXX",
	status: "submitted",
});

for (const submission of queue.data) {
	console.log(submission.id, submission.status);
}
```

```python Python theme={null}
queue = client.bounty_submissions.list(
    bounty_id="bnty_XXXXXXXX",
    status="submitted",
)

for submission in queue.data:
    print(submission.id, submission.status)
```

En indsendelse bevæger sig gennem fire tilstande:

| `status` | Betydning |
| - | - |
| `in_progress` | Et aktivt forsøg, der ikke har indsendt dokumentation |
| `submitted` | Afventer en beslutning |
| `approved` | Accepteret, og den deponerede belønning udbetales |
| `denied` | Afvist. `denial_reason` indeholder årsagen, når der findes en, der kan vises, og er ellers `null` |

> [!WARNING]
>
> Godkendelse og afvisning sker i Whop-dashboardet. API'et har ingen operation til godkendelse eller afvisning, så dit produkt kan vise køen og dens resultater, men en person træffer beslutningen i Whop.

Bounties udsender ingen webhooks. For at afspejle resultater i dit eget produkt skal du polle `GET /bounty_submissions` filtreret til bountyen. Én gang i minuttet passer til en kø, som en person gennemgår. Skru ned til hvert par minutter, når en bounty ikke har haft nogen nylig aktivitet.

## Annullér en bounty

[`POST /bounties/{id}/cancel`](https://docs.whop.com/da/api-reference/bounties/cancel) refunderer straks finansieringskilden, når intet arbejde er undervejs. Når arbejde er under gennemgang, stopper det nye indsendelser og annullerer, når det arbejde er afgjort og udbetalt.

Gentagelse af anmodningen gør intet. En bounty, der allerede har udbetalt alle pladser, returnerer en `400`.

## Anmodninger, der består validering og alligevel mislykkes

Fire regler, som anmodningsskemaet ikke kan udtrykke. Hver returnerer en fejl, selvom body'en er velformet:

* `experience_id` udeladt uden at `account_id` er angivet.
* `frequency` sendt uden `publish_at`.
* `capture_spec` sendt, når `business_goal_type` er noget andet end `data_capture`.
* En `deliverable`, der hverken indeholder et link eller en fil.

## Næste trin

> [card] [Oversigt over bounties](https://docs.whop.com/da/developer/bounties/overview.md)
>
> Objekterne, og hvordan de hænger sammen.

> [card] [Upload filer](https://docs.whop.com/da/developer/guides/upload-files.md)
>
> Få de fil-ID'er, en leverance refererer til.

> [card] [Bounties-reference](https://docs.whop.com/da/api-reference/bounties/bounty)
>
> Anmodnings- og svarformer for alle endpoints.

> [card] [Reference for bounty-indsendelser](https://docs.whop.com/da/api-reference/bounty-submissions/retrieve-bounty-submission.md)
>
> Indsendelsesobjektet og dets filtre.


## Related topics

- [Bounties](https://docs.whop.com/da/developer/bounties/overview.md)
- [Workforce-bounty](https://docs.whop.com/da/api-reference/legacy/bounties/workforce-bounty.md)
- [Bounties API](https://docs.whop.com/da/api-reference/bounties/bounty.md)
