• A Bubbling account with access to your project.
• Access to the application that sends your chatbot transcripts or messages.
• A developer or technical teammate for the integration. The example below needs a terminal with curl.

1. In Bubbling, open Connect. If a source already exists, select New connection.
2. Select REST API.
3. Select Generate key.
4. Copy the key into your application configuration.

1. Replace YOUR_API_KEY in this request with your key.
2. Run the request from your terminal.

curl https://ingest.bubbling.ai/v1/conversations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"conversations":[{
    "conversationId":"help-center-example-1",
    "messages":[{
      "messageId":"message-1",
      "role":"visitor",
      "content":"I want to cancel my subscription.",
      "createdAt":"2026-09-17T10:00:00Z"
    }]
  }]}'

A successful request returns an accepted count. Open Conversations in the same project to check the transcript.

The accepted count tells you how many conversations Bubbling received. It does not mean that a monitor found a match.

The API also accepts individual messages at /v1/messages. The same conversation and message IDs update existing records without duplicates.

• For a 401 response, check the key and the Authorization: Bearer header.
• For a 400 response, correct the field named in the error, then resend the batch with the same IDs.
• If conversations appear in the wrong project, use the API key from the project you want to import into.