Basecamp icon

Basecamp

Interact with Basecamp API

Actions119

Message → Create a Message

AI-generated

Overview

This node operation creates a new message within a specified project and message board in Basecamp. It is useful for automating communication workflows, such as posting announcements, updates, or discussions directly into Basecamp message boards. For example, a user can automatically create a message to notify team members about project milestones or important events.

Use Case Examples

  1. Automatically post a project update message to a Basecamp message board when a task is completed.
  2. Send a notification message to a specific message board when a new client inquiry is received.

Properties

Name Meaning
Project ID The ID of the project (bucket) where the message will be created. Used in the API endpoint path.
messageBoardId The ID of the message board within the project where the message will be posted. Used in the API endpoint path.
Subject The title of the message to be created.
Status The status of the message; setting it to 'active' publishes the message immediately.
Content The body content of the message, which may include HTML formatting.
Category ID Optional. The ID of the message type or category to classify the message.
Notification Recipients Optional. An array of IDs representing people to be notified about the new message.
Return Full Response Whether to return the full API response including status code, headers, and body instead of only the body.
Request Options Additional request settings such as batching, SSL certificate validation, proxy, and timeout options.

Output

JSON

  • id - The unique identifier of the created message.
  • subject - The title of the created message.
  • status - The status of the created message.
  • content - The body content of the created message.
  • category_id - The category ID assigned to the message, if any.
  • subscriptions - List of people notified about the message.
  • created_at - Timestamp when the message was created.

Dependencies

  • An API key credential for Basecamp OAuth2 authentication is required.

Troubleshooting

  • Ensure that the Project ID and messageBoardId are valid and correspond to existing entities in Basecamp to avoid 404 errors.
  • If the message status is not set to 'active', the message may not be published immediately.
  • Check that the content and subject fields are not empty to prevent validation errors from the API.
  • If using notification recipients, ensure the IDs are valid user IDs in Basecamp.
  • Timeout errors may occur if the server is slow to respond; adjust the timeout setting accordingly.

Links

Discussion