FloatMessage

REST Resources

All endpoints are under https://floatmessage.com/api/v1 and require a Bearer API key. Domain-scoped endpoints accept an optional ?domain= parameter. For machine-readable details, see the OpenAPI spec or the API Explorer.

Account

GET
/me

Current account, plan, and the resolved domain.

Messages (domain-scoped)

GET
/messages

List floating messages. ?archived=true for the archive.

POST
/messages

Create a message (name, template, htmlContent, targeting, schedule).

GET
/messages/{id}

Get a single message.

PATCH
/messages/{id}

Partial update of any message field.

DELETE
/messages/{id}

Archive, or ?permanent=true to delete an archived message.

Landing Pages

GET
/landing-pages

List landing pages.

POST
/landing-pages

Create from a template (templateId, name, brand).

GET
/landing-pages/{id}

Get a single landing page.

PATCH
/landing-pages/{id}

Update title, brand, sections, lead form.

POST
/landing-pages/{id}/publish

Recompile and publish.

POST
/landing-pages/{id}/unpublish

Take a page offline.

GET
/landing-pages/{id}/leads

List lead-form submissions.

Domains

GET
/domains

List domains with message counts.

POST
/domains

Add a domain (subject to plan limits).

DELETE
/domains/{id}

Remove a domain and all its data.

Knowledge base (domain-scoped)

GET
/knowledge

List knowledge items.

POST
/knowledge

Add a note or URL (scraped on create).

GET
/knowledge/{id}

Get a knowledge item.

PATCH
/knowledge/{id}

Update title, content, enabled, position.

DELETE
/knowledge/{id}

Delete a knowledge item.

Submissions & Analytics (domain-scoped)

GET
/form-submissions

List form submissions. ?messageId= to filter.

GET
/survey-responses

List survey responses. ?messageId= to filter.

GET
/analytics

Event summary. ?from=&to=&messageId= optional.

Live Chat (domain-scoped)

GET
/conversations

List conversations. ?status=OPEN|CLOSED.

GET
/conversations/{id}

Get a conversation.

GET
/conversations/{id}/messages

List messages in a conversation.

POST
/conversations/{id}/messages

Send an owner reply ({ content }).

Example: send a chat reply

curl -X POST \
  https://floatmessage.com/api/v1/conversations/CONV_ID/messages \
  -H "Authorization: Bearer fm_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content":"Thanks for reaching out - happy to help!"}'