Skip to content

message_boards.md

Latest commit

 

History

History
89 lines (74 loc) · 3.14 KB

message_boards.md

File metadata and controls

89 lines (74 loc) · 3.14 KB

Message Boards

All messages under a project are children of a Message Board resource.

Endpoints:

Get message board

  • GET /message_boards/2.json will return the message board with an ID of 2.

To get the message board ID for a project, see the Get a project endpoint's dock payload. To retrieve its messages, see the Get messages endpoint.

Example JSON Response
{
  "id": 1069479392,
  "status": "active",
  "visible_to_clients": false,
  "created_at": "2026-02-12T00:09:34.613-06:00",
  "updated_at": "2026-02-26T10:41:51.038-06:00",
  "title": "Message Board",
  "inherits_status": true,
  "type": "Message::Board",
  "url": "https://3.basecampapi.com/195539477/buckets/2085958504/message_boards/1069479392.json",
  "app_url": "https://3.basecamp.com/195539477/buckets/2085958504/message_boards/1069479392",
  "bookmark_url": "https://3.basecampapi.com/195539477/my/bookmarks/BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiLmdpZDovL2JjMy9SZWNvcmRpbmcvMTA2OTQ3OTM5Mj9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg1yZWFkYWJsZQY7AFQ=--5b36411ed69f8efd9f978730efb236662fbb4bf0.json",
  "position": 1,
  "bucket": {
    "id": 2085958504,
    "name": "The Leto Laptop",
    "type": "Project"
  },
  "creator": {
    "id": 1049715913,
    "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkxMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--e627c45e6b34e08862da23906862412620e4d5d9",
    "name": "Victor Cooper",
    "email_address": "victor@honchodesign.com",
    "personable_type": "User",
    "title": "Chief Strategist",
    "bio": "Don’t let your dreams be dreams",
    "location": "Chicago, IL",
    "created_at": "2026-02-12T00:08:49.342-06:00",
    "updated_at": "2026-02-12T00:08:50.871-06:00",
    "admin": true,
    "owner": true,
    "client": false,
    "employee": true,
    "time_zone": "America/Chicago",
    "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBMlkkT4=--5fe7b70fbee7a7f0e2e1e19df7579e5d880c753d/avatar",
    "company": {
      "id": 1033447817,
      "name": "Honcho Design"
    },
    "can_ping": true,
    "can_manage_projects": true,
    "can_manage_people": true,
    "can_access_timesheet": true,
    "can_access_hill_charts": true
  },
  "messages_count": 9,
  "messages_url": "https://3.basecampapi.com/195539477/buckets/2085958504/message_boards/1069479392/messages.json",
  "app_messages_url": "https://3.basecamp.com/195539477/buckets/2085958504/message_boards/1069479392/messages"
}
Copy as cURL
curl -s -H "Authorization: Bearer $ACCESS_TOKEN" https://3.basecampapi.com/$ACCOUNT_ID/message_boards/2.json

Legacy project-scoped routes

The following project-scoped routes are still supported and will remain available, but flat routes above are the canonical form for new integrations.