Skip to content

client_replies.md

Latest commit

 

History

History
154 lines (141 loc) · 6.13 KB

client_replies.md

File metadata and controls

154 lines (141 loc) · 6.13 KB

Client replies

Client replies are nested under the recording ID of a client correspondence or client approval.

Endpoints:

Get client replies

  • GET /buckets/1/client/recordings/2/replies.json will return a paginated list of client replies for the recording with ID 2.
Example JSON Response
[
  {
    "id": 1069479623,
    "status": "active",
    "visible_to_clients": false,
    "created_at": "2025-12-30T17:01:00.000Z",
    "updated_at": "2025-12-30T17:01:00.000Z",
    "title": "Re: Project kickoff!",
    "inherits_status": true,
    "type": "Client::Reply",
    "url": "https://3.basecampapi.com/195539477/buckets/2085958505/client/replies/1069479623.json",
    "app_url": "https://3.basecamp.com/195539477/buckets/2085958505/client/correspondences/1069479622#__recording_1069479623",
    "bookmark_url": "https://3.basecampapi.com/195539477/my/bookmarks/BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiLmdpZDovL2JjMy9SZWNvcmRpbmcvMTA2OTQ3OTYyMz9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg1yZWFkYWJsZQY7AFQ=--811dc39ad285287723bd6bd6bb2c8b73e55dbfe4.json",
    "parent": {
      "id": 1069479622,
      "title": "Project kickoff!",
      "type": "Client::Correspondence",
      "url": "https://3.basecampapi.com/195539477/buckets/2085958505/client/correspondences/1069479622.json",
      "app_url": "https://3.basecamp.com/195539477/buckets/2085958505/client/correspondences/1069479622"
    },
    "bucket": {
      "id": 2085958505,
      "name": "The Leto Locator",
      "type": "Project"
    },
    "creator": {
      "id": 1049715935,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkzNT9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--d8bb591232517f997e82d5a8f68e4c9c9033e60f",
      "name": "Stephen Early",
      "email_address": "stephen@letobrand.com",
      "personable_type": "Client",
      "title": "National Directives Director",
      "bio": null,
      "location": null,
      "created_at": "2026-02-12T06:08:57.319Z",
      "updated_at": "2026-02-12T06:08:57.319Z",
      "admin": false,
      "owner": false,
      "client": false,
      "employee": false,
      "time_zone": "Etc/UTC",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBN9kkT4=--7df21243a6650f691505323b707250c92aeb468d/avatar?v=1",
      "company": {
        "id": 1033447818,
        "name": "Leto Brand"
      },
      "can_ping": true,
      "can_manage_projects": false,
      "can_manage_people": false,
      "can_access_timesheet": false,
      "can_access_hill_charts": false
    },
    "content": "Hi all - we're excited to get started too."
  }
]
Copy as cURL
curl -s -H "Authorization: Bearer $ACCESS_TOKEN" https://3.basecampapi.com/$ACCOUNT_ID/buckets/1/client/recordings/2/replies.json

Get a client reply

  • GET /buckets/1/client/recordings/2/replies/3.json will return the client reply with an ID of 3 for the recording with an ID of 2.
Example JSON Response
{
  "id": 1069479628,
  "status": "active",
  "visible_to_clients": false,
  "created_at": "2025-12-30T20:23:00.000Z",
  "updated_at": "2025-12-30T20:23:00.000Z",
  "title": "Re: Project kickoff!",
  "inherits_status": true,
  "type": "Client::Reply",
  "url": "https://3.basecampapi.com/195539477/buckets/2085958505/client/replies/1069479628.json",
  "app_url": "https://3.basecamp.com/195539477/buckets/2085958505/client/correspondences/1069479622#__recording_1069479628",
  "bookmark_url": "https://3.basecampapi.com/195539477/my/bookmarks/BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiLmdpZDovL2JjMy9SZWNvcmRpbmcvMTA2OTQ3OTYyOD9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg1yZWFkYWJsZQY7AFQ=--7d9d474cb5fa29090a4727a7f5c7542a7a926046.json",
  "parent": {
    "id": 1069479622,
    "title": "Project kickoff!",
    "type": "Client::Correspondence",
    "url": "https://3.basecampapi.com/195539477/buckets/2085958505/client/correspondences/1069479622.json",
    "app_url": "https://3.basecamp.com/195539477/buckets/2085958505/client/correspondences/1069479622"
  },
  "bucket": {
    "id": 2085958505,
    "name": "The Leto Locator",
    "type": "Project"
  },
  "creator": {
    "id": 1049715938,
    "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTkzOD9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--4ccc567a0a3b10e354bca909b704637b601f0b16",
    "name": "Annie Bryan",
    "email_address": "annie@honchodesign.com",
    "personable_type": "User",
    "title": "Central Markets Manager",
    "bio": "To open a store is easy, to keep it open is an art",
    "location": null,
    "created_at": "2026-02-12T06:08:57.340Z",
    "updated_at": "2026-02-12T06:08:57.340Z",
    "admin": false,
    "owner": false,
    "client": false,
    "employee": true,
    "time_zone": "America/Chicago",
    "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBOJkkT4=--732a71fbd28ec10d9bf4466abd3588a8bea40bdb/avatar?v=1",
    "company": {
      "id": 1033447817,
      "name": "Honcho Design"
    },
    "can_ping": true,
    "can_manage_projects": true,
    "can_manage_people": true,
    "can_access_timesheet": false,
    "can_access_hill_charts": true
  },
  "content": "Hi Leto team, this it's Annie. I'll be your day to day contact for the project, so keep me on your speed dial (or speed email, perhaps more accurately!) Feel free to reach out to me with any questions at all, and I'll be posting up some outlines, timelines, etc. very shortly."
}
Copy as cURL
curl -s -H "Authorization: Bearer $ACCESS_TOKEN" https://3.basecampapi.com/$ACCOUNT_ID/buckets/1/client/recordings/2/replies/3.json