Basecamp · AsyncAPI Specification
Basecamp Webhook Events
Version 1.0
The Basecamp webhook system delivers real-time HTTP notifications to registered HTTPS endpoints when events occur within a Basecamp project. Webhooks are configured per project with a payload URL and an optional list of resource types. Basecamp sends an HTTP POST with a JSON payload to the registered URL whenever a subscribed event occurs. Delivery is attempted up to 10 times with exponential backoff before a webhook is deactivated if the endpoint fails to return a 2xx HTTP response.
View Spec
View on GitHub
CollaborationProject ManagementRESTSaaSTeam CommunicationAsyncAPIWebhooksEvents
Channels
/webhook
Receive a Basecamp webhook event notification
The HTTPS endpoint on the subscriber's server that receives webhook notifications from Basecamp. Basecamp sends HTTP POST requests with JSON payloads. Subscribers should respond with a 2xx status code within a reasonable timeout to acknowledge receipt. Failure to respond with 2xx after 10 attempts will cause Basecamp to deactivate the webhook.
Messages
MessageCreated
Message Created
A new message was created on a message board
MessageUpdated
Message Updated
An existing message was updated
MessageArchived
Message Archived
A message was archived
MessageTrashed
Message Trashed
A message was moved to trash
TodoCreated
To-Do Created
A new to-do was created
TodoUpdated
To-Do Updated
An existing to-do was updated
TodoCompleted
To-Do Completed
A to-do was marked as completed
TodoUncompleted
To-Do Uncompleted
A to-do was marked as incomplete
TodoArchived
To-Do Archived
A to-do was archived
TodoTrashed
To-Do Trashed
A to-do was moved to trash
TodolistCreated
To-Do List Created
A new to-do list was created
TodolistUpdated
To-Do List Updated
An existing to-do list was updated
TodolistArchived
To-Do List Archived
A to-do list was archived
TodolistTrashed
To-Do List Trashed
A to-do list was moved to trash
DocumentCreated
Document Created
A new document was created in a vault
DocumentUpdated
Document Updated
An existing document was updated
DocumentArchived
Document Archived
A document was archived
DocumentTrashed
Document Trashed
A document was moved to trash
CommentCreated
Comment Created
A new comment was posted on a recording
CommentUpdated
Comment Updated
An existing comment was updated
CommentTrashed
Comment Trashed
A comment was moved to trash
CardCreated
Card Created
A new card was created on a card table
CardUpdated
Card Updated
An existing card was updated or moved
CardArchived
Card Archived
A card was archived
CardTrashed
Card Trashed
A card was moved to trash
ScheduleEntryCreated
Schedule Entry Created
A new schedule entry was created
ScheduleEntryUpdated
Schedule Entry Updated
An existing schedule entry was updated
ScheduleEntryArchived
Schedule Entry Archived
A schedule entry was archived
ScheduleEntryTrashed
Schedule Entry Trashed
A schedule entry was moved to trash
UploadCreated
Upload Created
A new file upload was created in a vault
UploadUpdated
Upload Updated
An existing upload was updated
UploadArchived
Upload Archived
An upload was archived
UploadTrashed
Upload Trashed
An upload was moved to trash
QuestionAnswerCreated
Question Answer Created
A new answer was submitted to an automatic check-in question
QuestionAnswerUpdated
Question Answer Updated
An answer to an automatic check-in question was updated
QuestionPaused
Question Paused
An automatic check-in question was paused
QuestionResumed
Question Resumed
A paused automatic check-in question was resumed
Servers
https
basecamp
https://3.basecampapi.com
Basecamp sends webhook event notifications as HTTP POST requests originating from Basecamp infrastructure. Receiving endpoints must be publicly accessible HTTPS URLs registered via the Webhooks REST API.