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();