PricingBook a demoDemo

Reading data

Messages

DMs are how brand staff communicate with creators inside UGCBloom. Because conversation contents are sensitive, the message endpoints require an API key with the messages scope. Opt-in only.

GET/conversationsscope · messages

List conversations

Every conversation involving someone in your org. Includes participants and the last message preview.
pageinteger

Page number

per_pageinteger

Items per page

const response = await fetch(
  "https://ugcbloom.com/api/v1/conversations", {
  headers: {
    "Authorization": "Bearer ugcb_live_your_api_key_here"
  }
}
);

const data = await response.json();
GET/conversations/{conversationId}/messagesscope · messages

Get messages in a conversation

Paginated message history with sender info, attachments, and reactions.
pageinteger

Page number

per_pageinteger

Messages per page

const response = await fetch(
  "https://ugcbloom.com/api/v1/conversations/:conversationId/messages", {
  headers: {
    "Authorization": "Bearer ugcb_live_your_api_key_here"
  }
}
);

const data = await response.json();