Basecamp

Interact with Basecamp API

Actions76

Campfire Actions
- Create a Campfire Line
- Delete a Campfire Line
- Get a Campfire
- Get a Campfire Line
- Get Campfire Lines
- Get Campfires
Card Table Actions
- Create a Card
- Create a Column
- Get a Card
- Get a Card Table
- Get a Column
- Get Cards in a Column
- Move a Card
- Move a Column
- Update a Card
- Update a Column
Chatbot Actions
- Create a Chatbot
- Create a Chatbot Line
- Delete a Chatbot
- Get a Chatbot
- Get All Chatbots
- Update a Chatbot
Client Approval Actions
- Get a Client Approval
- Get Client Approvals
Client Correspondence Actions
- Get a Client Correspondence
- Get Client Correspondences
Client Reply Actions
- Get Client Replies
- Get a Client Reply
Client Visibility Actions
- Toggle Client Visibility
Comment Actions
- Get Comments
- Create a Comment
- Get a Comment
- Update a Comment
Document Actions
- Get Documents
- Create a Document
- Get a Document
- Update a Document
Event Actions
- Get Events
Forward Actions
- Get Forwards
- Get a Forward
Inbox Actions
- Get Inbox
Inbox Reply Actions
- Get Inbox Replies
- Get an Inbox Reply
Lineup Marker Actions
- Create a Marker
- Update a Marker
- Delete a Marker
Message Actions
- Get Messages
- Create a Message
- Get a Message
- Update a Message
Message Board Actions
- Get Message Board
Message Type Actions
- Create a Message Type
- Destroy a Message Type
- Get a Message Type
- Get Message Types
- Update a Message Type
Person Actions
- Get a Person
- Get My Profile
- Get People
- Get People on a Project
- Manage People on a Project
Project Actions
- Create a Project
- Get a Project
- Get Projects
- Trash a Project
- Update a Project
Question Actions
- Get Questions
- Create a Question
- Get a Question
- Update a Question
Question Answer Actions
- Get Question Answers
- Get a Question Answer
Questionnaire Actions
- Get Questionnaire
Recording Actions
- Get Recordings
- Trash a Recording
- Archive a Recording

Overview

This node allows users to create a new message type within a specified project in Basecamp. Message types are customizable categories or labels that help organize and classify messages in Basecamp projects. This operation is useful when you want to define specific message types with unique names and emoji icons to better structure communication within your projects.

Practical examples include:

Creating a "Bug Report" message type with a bug emoji for tracking issues.
Defining a "Feature Request" message type with a lightbulb emoji to highlight new ideas.
Adding a "Meeting Notes" message type with a notebook emoji to categorize meeting summaries.

Properties

Name	Meaning
Project ID	The numeric ID of the project (bucket) where the message type will be created.
Name	The name of the message type to create (e.g., "Bug Report", "Feature Request").
Icon	The emoji icon representing the message type (e.g., 🐞, 💡).
Return Full Response	Whether to return the full HTTP response including status code and headers instead of just the response body.

Output

The node outputs JSON data representing the newly created message type as returned by the Basecamp API. This typically includes details such as the message type's ID, name, icon, and associated project information.

If the "Return Full Response" property is enabled, the output will include the entire HTTP response object, containing status code, headers, and body.

No binary data is produced by this node.

Dependencies

Requires an active connection to the Basecamp API using OAuth2 authentication.
The user must provide valid credentials with access rights to the target Basecamp account and project.
The node uses the Basecamp API endpoint structured as https://3.basecampapi.com/{accountId}/buckets/{projectId}/message_types.json to create the message type.

Troubleshooting

Invalid Project ID: If the provided project ID does not exist or the authenticated user lacks access, the API will return an error. Verify the project ID and permissions.
Missing Required Fields: Ensure that both the "Name" and "Icon" fields are provided; otherwise, the API will reject the request.
Authentication Errors: If the OAuth2 token is expired or invalid, re-authenticate the credentials.
API Rate Limits: Excessive requests may lead to rate limiting; handle retries accordingly.

Common error messages:

404 Not Found: Project ID is incorrect or inaccessible.
401 Unauthorized: Authentication failure.
422 Unprocessable Entity: Validation errors such as missing or invalid name/icon.