The Fluid Company APIs provide a comprehensive set of APIs designed to integrate Fluid's powerful services into your applications seamlessly. These APIs use Company API tokens for authentication and provide full access to manage your company's resources including users, orders, products, media, and more.
For APIs that authenticate with User tokens, see the Rep APIs documentation. For public SDK APIs, see the Public SDK APIs documentation.
Informative Catchup: This is the most common type of custom catchup. For instance, if the back office needs to share information with a user, they can use this API to create a catchup. An optional link can be included for further follow-up.
Action-Based Catchup: This type of custom catchup allows you to add an existing catchup action. For example, you might create a catchup for an affiliate to notify them about specific behavior from one of their contacts. This behavior might not be covered by our existing 26 catchup matrix.
Types of CatchUp Action Supported For Custom CatchUp
LinkRedirectionCatchUpAction: Use this action to redirect a user from the catchup card to a destination where other actions can be executed.
SendSmsCatchUpAction: Use this action to allow users to send an SMS message to a contact from within a catchup card.
ToDoCatchUpAction: Use this action to allow users to add a to-do item to their task list from within the catchup card.
Specific contact assigned to an affiliate should be provided to use the SendSmsCatchUpAction and ToDoCatchUpAction.
typestringrequired
Example: "custom_catch_up"
titlestringrequired
Example: "Talk to your favorite visitor."
headerstring
affiliate_idinteger(int32)required
Example: 1
actionsobject(CatchUpAction)required
Example: {"type":"LinkRedirectionCatchUpAction","action_prompt":"Craft a short friendly message to a visitor, visiting my site constantly and buying products."}
actions.typestringrequired
Example: "LinkRedirectionCatchUpAction"
actions.action_promptstringrequired
Example: "Craft a short friendly message to a visitor, visiting my site constantly and buying products."
Mock server https://fluid-commerce.redocly.app/_mock/docs/apis/company.api/api/company/catch_up/custom_catch_ups
Production server with company subdomain https://myco.fluid.app/api/company/catch_up/custom_catch_ups
Local development server http://fluid.lvh.me:3000/api/company/catch_up/custom_catch_ups
curl
JavaScript
Node.js
Python
Java
C#
PHP
Go
Ruby
R
Payload
curl-i-X POST \
https://fluid-commerce.redocly.app/_mock/docs/apis/company.api/api/company/catch_up/custom_catch_ups \-H'Content-Type: application/json'\-d'{
"type": "custom_catch_up",
"title": "Update Your Bank Details",
"description": "Your credit card is going to expire on 24th December. Please update your details.",
"affiliate_id": 1,
"actions": {
"type": "LinkRedirectionCatchUpAction",
"data": {
"button_text": "View Back Office",
"redirect_to": "https://fluid.app/back_office"
}
}
}'
Responses
Created
Headers
Content-Typestring
The content type of the response
Example: "application/json"
Content-Lengthstring
The length of the response content in bytes
Example: "981"
X-Request-Idstring
A unique identifier for the request
Example: "b1b7bf86-146e-4c66-b4c6-ac6f0f9ddafa"
Bodyapplication/json; charset=utf-8
any
Response
application/json; charset=utf-8
{
"status": "success"
}
Categories
Operations
Checkout
Operations
Collections
Operations
Companies
Operations
Company Countries
Operations
Compliance
Content compliance scanning endpoints for products, media, playlists, categories, collections, posts, and enrollment packs
Operations
Contacts
Operations
Conversations
Operations
Countries
Operations
Currencies
Operations
Custom Pages
Operations
Customer Notes
Operations
Customer Orders
Operations
Customers
Operations
DAM
Digital Asset Management endpoints
Operations
Default Libraries
Operations
Devices
Operations
Discounts
Operations
Display Settings
Operations
Domains
Operations
Drop Zones
Operations
Droplet Categories
Operations
Droplet Installations
Operations
Droplets
Operations
Enrollment Packs
Operations
Enrollments
Operations
Entities
Operations
Events
Operations
Fantasy Points
Operations
Feature Flags
Operations
File Resources
Operations
Fluid Pay
Operations
Form Elements
Operations
Forms
Operations
Global Embeds
Operations
Impersonation
Operations
Inventory Levels
Operations
Labels
Operations
Languages
Operations
Libraries
Operations
Lighthouse
Lighthouse performance scanning endpoints for products, media, playlists, categories, collections, posts, and enrollment packs
Operations
MCC Codes
Operations
Media
Operations
Menus
Operations
Messages
Operations
Metafield Definitions
Operations
Metafields
Operations
Mobile Widgets
Operations
Multi-Factor Authentications
Operations
Notifications
Operations
Onboarding
Operations
Onboarding Info
Operations
Order Fulfillments
Operations
Orders
Operations
Owners
Operations
Pages
Operations
Payment
Operations
Payment Accounts
Operations
Payment Integrations
Operations
Payments
Operations
Paypal
Operations
Points
Operations
Points Ledgers
Operations
Points Values
Operations
Posts
Operations
Product Bundles
Operations
Product Images
Operations
Product Redirects
Operations
Product Subscription Plans
Operations
Products
Operations
Prompts
Operations
Public Assets
Operations
Public Companies
Operations
Public Drop Zones
Operations
Ranks
Operations
Recipients
Operations
Redirects
Operations
Refunds
Operations
Reps
Operations
Roles
Operations
Root Themes
Operations
Search
Operations
Share Statistics
Share statistics endpoints for media, products, playlists, categories, collections, posts, pages, and enrollment packs
Social Media