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

# bounty.updated

Occurs whenever a [bounty](/help/article/program-bounties) in your program is updated.

> [!TIP]
>
> The payload contains the bounty's full, updated state. Deleting a bounty does
> not trigger this event.

## Response body parameters

All webhook payloads follow a consistent top-level structure with
event-specific data nested within the `data` object.

**id** `string`

The event ID.
**event** `string`

The event type that triggered the webhook (e.g., `bounty.updated`).
**createdAt** `string`

ISO 8601 timestamp when the webhook event was created.
**data** `object`

Event-specific data containing detailed information about the event. The
data object for the `bounty.updated` event contains the following
parameters:

**object parameters**

**id** `string`

Unique identifier for the bounty (e.g. `bnty_...`).

**name** `string | null`

The name of the bounty.

**description** `string | null`

The description of the bounty, outlining its rules and requirements.

**type** `string`

The type of bounty: `submission` (awarded based on partner
submissions) or `performance` (awarded based on partner
performance).

**startMode** `string`

How the bounty's start date is determined: `absolute` (starts
at a specific date and time) or `relative` (starts when a partner
joins the program).

**startsAt** `string | null`

ISO 8601 timestamp when the bounty starts. Only applicable when 
`startMode` is `absolute`.

**endsAt** `string | null`

ISO 8601 timestamp when the bounty ends. Only applicable when 
`startMode` is `absolute`.

**endsAfterDays** `number | null`

Number of days after a partner joins the program that the bounty stays
open. Only applicable when `startMode` is `relative`.

**submissionsOpenAt** `string | null`

ISO 8601 timestamp after which partners can finalize their submissions.
Only applicable for `submission` bounties.

**submissionFrequency** `string | null`

How often partners can submit: `day`, `week`, or 
`month`. Only applicable when `maxSubmissions` is
greater than 1.

**maxSubmissions** `number`

The maximum number of submissions a partner can enter.

**rewardAmount** `number | null`

The reward amount in cents (e.g. `50000` = \$500.00).

**rewardDescription** `string | null`

A custom reward description for `submission` bounties.

**performanceCondition** `object | null`

The condition a partner must meet to be awarded a `performance` 
bounty.

**performanceCondition object**

**attribute** `string`

The metric being measured: `totalLeads`, 
`totalConversions`, `totalSaleAmount`, or 
`totalCommissions`.

**operator** `string`

The comparison operator. Currently always `gte` (greater
than or equal to).

**value** `number`

The target value. Amounts (`totalSaleAmount`, 
`totalCommissions`) are in cents.

**socialMetricsLastSyncedAt** `string | null`

ISO 8601 timestamp when social metrics were last synced for this bounty.

**performanceScope** `string | null`

Which performance data counts toward a `performance` bounty: 
`lifetime` (all-time data) or `new` (only data after
the bounty starts).

**submissionRequirements** `object | null`

The requirements a submission must meet to be finalized. Only applicable
for `submission` bounties.

**submissionRequirements object**

**image** `object`

Present if image uploads are required. May include `max`,
the maximum number of images.

**url** `object`

Present if URLs are required. May include `max`, the
maximum number of URLs, and `domains`, an array of allowed
domains.

**socialMetrics** `object`

Present for social content bounties. Includes `platform` 
(`youtube`, `tiktok`, `instagram`, 
`twitter`, or `linkedin`), `metric` 
(`views` or `likes`), and optionally 
`minCount` and `incrementalBonus`.

**groups** `array`

The partner groups this bounty is available to, as objects with an 
`id`.

**partnerTags** `array`

The partner tags this bounty is available to, as objects with an 
`id`.

```json Response theme={null}
{
  "id": "evt_8nMWc3BdUKqWLVoHbHE2mlTzH",
  "event": "bounty.updated",
  "createdAt": "2026-10-09T09:12:45.000Z",
  "data": {
    "id": "bnty_1K39DGZG3MHY9RP4PD0AS2C5P",
    "name": "Create a video about Dub and earn $1,000",
    "description": "Create a video about Dub and earn $1,000.",
    "type": "submission",
    "startsAt": "2026-10-08T17:34:00.000Z",
    "endsAt": "2026-11-08T17:34:00.000Z",
    "startMode": "absolute",
    "endsAfterDays": null,
    "submissionsOpenAt": null,
    "submissionFrequency": null,
    "maxSubmissions": 1,
    "rewardAmount": 100000,
    "rewardDescription": null,
    "performanceCondition": null,
    "socialMetricsLastSyncedAt": null,
    "performanceScope": null,
    "submissionRequirements": {
      "image": {},
      "url": {}
    },
    "groups": [
      {
        "id": "grp_1K2E25381GVMG7HHM057TB92F"
      }
    ],
    "partnerTags": []
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.