Event Catalog

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:

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

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.

Sample Request Payload

Request data sample

{
  "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.

Sample Request Payload

Request data sample

{
  "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.

Sample Request Payload

Request data sample

{
  "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.

Sample Request Payload

Request data sample

{
  "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.

Sample Request Payload

Request data sample

{
  "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

Sample Request Payload

Request data sample

{
  "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.

Sample Request Payload

Request data sample

{
  "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"
  }
}

Get Started

Integrations

`proposal.accepted`

`chat.message.sent`

`bid_intent.scheduled`

`job.matched`

`bid_intent.submitted`

`proposal.new_result`

`invite.new`

​proposal.accepted

​chat.message.sent

​bid_intent.scheduled

​job.matched

​bid_intent.submitted

​proposal.new_result

​invite.new

`proposal.accepted`

`chat.message.sent`

`bid_intent.scheduled`

`job.matched`

`bid_intent.submitted`

`proposal.new_result`

`invite.new`