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

# Event Catalog

> List of supported event types and their payload.

Every payload includes a top-level `eventType` field with the name of the event, so an endpoint subscribed to several events can tell them apart:

```js theme={null}
switch (req.body.eventType) {
  case "proposal.new_result":
    // ...
    break;
  case "chat.message.sent":
    // ...
    break;
}
```

> [!NOTE]
>
> We may add new fields to payloads over time. Ignore fields you don't use
> instead of rejecting payloads that contain them.

### `proposal.accepted`

Occurs whenever the customer **accepts a proposal on Upwork**.

> [accordion] Sample Request Payload
>
> ```json Request data sample icon="file-json" theme={null}
> {
>   "eventType": "proposal.accepted",
>   "proposal": {
>     "uid": "1234567890123456~0123456789012345678",
>     "coverLetter": "I'd love to help with this project...",
>     "status": "ACTIVE",
>     "createdAt": "2026-09-20T10:00:00.000Z"
>   },
>   "job": {
>     "slug": "~0123456789012345678",
>     "title": "Build a CRM integration",
>     "description": "We need a webhook-based integration with our CRM.",
>     "createdAt": "2026-09-18T09:00:00.000Z",
>     "publishedAt": "2026-09-18T09:05:00.000Z"
>   },
>   "freelancer": {
>     "uid": "freelancer-uid-1",
>     "name": "Jamie Rivera",
>     "photoUrl": "https://example.com/avatars/jamie.png",
>     "slug": "jamie-rivera"
>   },
>   "manager": {
>     "uid": "manager-uid-1",
>     "name": "Alex Chen",
>     "photoUrl": "https://example.com/avatars/alex.png",
>     "slug": "alex-chen"
>   },
>   "chat": {
>     "id": "chat-id-1"
>   },
>   "client": {
>     "name": "Acme Inc."
>   }
> }
> ```

### `chat.message.sent`

Occurs whenever the customer **sends you a new message in a conversation**.

> [accordion] Sample Request Payload
>
> ```json Request data sample icon="file-json" theme={null}
> {
>   "eventType": "chat.message.sent",
>   "proposal": {
>     "uid": "1234567890123456~0123456789012345678"
>   },
>   "message": {
>     "text": "Thanks for reaching out, let's schedule a call."
>   },
>   "chat": {
>     "id": "chat-id-1"
>   }
> }
> ```

### `bid_intent.scheduled`

Occurs whenever Auto-Bidder schedules a bid.

> [accordion] Sample Request Payload
>
> ```json Request data sample icon="file-json" theme={null}
> {
>   "eventType": "bid_intent.scheduled",
>   "bidAttempt": {
>     "id": "670000000000000000000001"
>   },
>   "job": {
>     "uid": "job-uid-1",
>     "title": "Build a CRM integration"
>   },
>   "jobSearch": {
>     "id": "670000000000000000000002"
>   }
> }
> ```

### `job.matched`

Occurs whenever a new Upwork job **matches one of your scanners**.

> [accordion] Sample Request Payload
>
> ```json Request data sample icon="file-json" theme={null}
> {
>   "eventType": "job.matched",
>   "job": {
>     "uid": "job-uid-1",
>     "slug": "~0123456789012345678",
>     "title": "Build a CRM integration",
>     "description": "We need a webhook-based integration with our CRM.",
>     "createdAt": "2026-09-18T09:00:00.000Z",
>     "publishedAt": "2026-09-18T09:05:00.000Z",
>     "budgetType": "HOURLY",
>     "fixedBudget": 0,
>     "minHourlyRate": 40,
>     "maxHourlyRate": 80,
>     "experienceLevel": "EXPERT",
>     "duration": 3,
>     "workload": 2,
>     "category": "Virtual Assistance",
>     "skills": [
>       "CRM",
>       "Webhooks",
>       "Node.js"
>     ],
>     "connectPrice": 6,
>     "isFeatured": false,
>     "clientInfo": {
>       "name": "Acme Inc.",
>       "totalSpent": 25000,
>       "totalHires": 12,
>       "hireRate": 0.65,
>       "country": "US",
>       "timeZone": "America/New_York",
>       "paymentVerificationStatus": true,
>       "feedbackScore": 4.9,
>       "feedbackCount": 34,
>       "avgRate": 55
>     }
>   },
>   "jobStream": {
>     "id": "670000000000000000000002",
>     "name": "CRM integrations"
>   },
>   "timestamp": "2026-09-25T12:00:00.000Z"
> }
> ```

### `bid_intent.submitted`

Occurs whenever Auto-Bidder **submits a proposal** on Upwork.

> [accordion] Sample Request Payload
>
> ```json Request data sample icon="file-json" theme={null}
> {
>   "eventType": "bid_intent.submitted",
>   "bidAttempt": {
>     "id": "670000000000000000000001"
>   },
>   "proposal": {
>     "uid": "1234567890123456~0123456789012345678",
>     "coverLetter": "I'd love to help with this project...",
>     "createdAt": "2026-09-20T10:00:00.000Z",
>     "questions": [
>       {
>         "question": "What's your availability?",
>         "answer": "I can start immediately, 30 hrs/week."
>       }
>     ],
>     "applicationCost": 6
>   },
>   "freelancer": {
>     "uid": "freelancer-uid-1",
>     "name": "Jamie Rivera",
>     "photoUrl": "https://example.com/avatars/jamie.png",
>     "slug": "jamie-rivera"
>   },
>   "job": {
>     "slug": "~0123456789012345678",
>     "title": "Build a CRM integration",
>     "description": "We need a webhook-based integration with our CRM.",
>     "createdAt": "2026-09-18T09:00:00.000Z",
>     "publishedAt": "2026-09-18T09:05:00.000Z"
>   },
>   "jobStream": {
>     "id": "670000000000000000000002",
>     "name": "CRM integrations"
>   }
> }
> ```

### `proposal.new_result`

Occurs whenever a sent proposal **gets a new status**, for example when the client views it or replies.

`proposal.status` is one of:

| Status | Meaning |
| - | - |
| `SENT` | The proposal was sent |
| `VIEWED_BY_CLIENT` | The client viewed the proposal |
| `CLIENT_REPLIED` | The client replied |
| `HIRED` | The client hired you |
| `CLOSED` | The job was closed |
| `DECLINED_BY_CLIENT` | The client declined the proposal |
| `WITHDRAWN` | The proposal was withdrawn |

> [accordion] Sample Request Payload
>
> ```json Request data sample icon="file-json" theme={null}
> {
>   "eventType": "proposal.new_result",
>   "proposal": {
>     "uid": "1234567890123456~0123456789012345678",
>     "status": "HIRED",
>     "timestamp": "2026-09-24T15:30:00.000Z"
>   },
>   "job": {
>     "uid": "job-uid-1",
>     "title": "Build a CRM integration"
>   }
> }
> ```

### `invite.new`

Occurs whenever one of your freelancers **receives a job invite** on Upwork.

> [accordion] Sample Request Payload
>
> ```json Request data sample icon="file-json" theme={null}
> {
>   "eventType": "invite.new",
>   "job": {
>     "slug": "~0123456789012345678",
>     "title": "Build a CRM integration",
>     "description": "We need a webhook-based integration with our CRM.",
>     "url": "https://www.upwork.com/jobs/~0123456789012345678",
>     "createdAt": "2026-09-18T09:00:00.000Z",
>     "publishedAt": "2026-09-18T09:05:00.000Z"
>   },
>   "client": {
>     "country": "US",
>     "avgHourlyRate": 55,
>     "totalSpent": 25000,
>     "totalHires": 12,
>     "hireRate": 0.65,
>     "feedbackCount": 34,
>     "feedbackScore": 4.9
>   },
>   "freelancer": {
>     "uid": "freelancer-uid-1",
>     "name": "Jamie Rivera",
>     "photoUrl": "https://example.com/avatars/jamie.png",
>     "slug": "jamie-rivera"
>   },
>   "invite": {
>     "message": "We'd love for you to apply to this job.",
>     "timestamp": "2026-09-25T08:00:00.000Z"
>   }
> }
> ```


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