Overview

This section provides detailed technical documentation for the Optimove Embedded Messaging V2 REST API.

While we strongly recommend using the Optimove Web SDK for all standard implementations, this API reference is for developers who need to build a deeply customized user interface from scratch.

Base URLs

The API domain you call will vary depending on the region your tenant is provisioned in.

  • EU: https://optimobile-inbox-srv-eu.optimove.net
  • US: https://optimobile-inbox-srv-us.optimove.net

Authentication & Required Parameters

All V2 API endpoints require the following query parameters for authentication and routing:

  • tenantId: Your tenant ID.
  • brandId: The ID of the specific brand you are targeting.

You can find these values on the Web Inbox settings page in your Optimove instance.

User Identification

To retrieve messages or report events for a specific user, you must identify them in your request. All endpoints that deal with user data require at least one of the following identifiers:

  • customerId
  • visitorId

API Endpoints

  • [POST] /api/v2/embedded-messages/get: Fetches messages for one or more containers for a given user.
  • [POST] /api/v2/embedded-messages/report-events: Reports user engagement events like reads, clicks, and deletes.