Set Follow-up Contact

PUThttps://api.repliz.com/public/contact/{contactId}/follow-up

Plan a follow-up with a contact. A contact has one follow-up at a time; setting it again replaces the current one. It is a reminder only and sends nothing to the contact, even with a message: to send it yourself, use Send Message with chatId or Reply Comment with lastCommentId from Get One Contact. In the Repliz app, due follow-ups show as a badge on the Contacts menu, and Count Contact returns how many are due.

Endpoint Details

• Authentication: Basic Auth (Authorization: Basic Base64(AccessKey:SecretKey))
• Access Tier: Standard+

Parameters

Parameter	Type	Required	Description
contactId	string	Yes	ID of the contact, the _id from Get Contact.

Request Body

Field	Type	Required	Description
at	string	Yes	When to follow up, as an ISO date and time in the future. Replaces the current follow-up.
note	string	Yes	What to follow up on, up to 500 characters. Can be empty.
message	string	No	The message to send when following up, written ahead, up to 1000 characters. Repliz never sends it by itself; in the app it is sent with one click as a DM or a reply to the latest comment. Empty when left out.

Example Request

cURL

curl -X PUT "https://api.repliz.com/public/contact/690a1f3ce12f2f72916f67e1/follow-up" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "at": "2026-11-05T02:00:00.000Z",
    "note": "Send the new catalog.",
    "message": "Halo kak, ini katalog terbaru kami."
  }'

Axios

import axios from 'axios';

const contactId = '690a1f3ce12f2f72916f67e1';

const response = await axios.put(
  `https://api.repliz.com/public/contact/${contactId}/follow-up`,
  {
    at: '2026-11-05T02:00:00.000Z',
    note: 'Send the new catalog.',
    message: 'Halo kak, ini katalog terbaru kami.',
  },
  {
    auth: {
      username: 'YOUR_ACCESS_KEY',
      password: 'YOUR_SECRET_KEY',
    },
  },
);

console.log(response.status);

Fetch

const credentials = btoa('YOUR_ACCESS_KEY:YOUR_SECRET_KEY');

const contactId = '690a1f3ce12f2f72916f67e1';

const response = await fetch(`https://api.repliz.com/public/contact/${contactId}/follow-up`, {
  method: 'PUT',
  headers: {
    Authorization: `Basic ${credentials}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    at: '2026-11-05T02:00:00.000Z',
    note: 'Send the new catalog.',
    message: 'Halo kak, ini katalog terbaru kami.',
  }),
});

console.log(response.status);

Response

204

// No content returned on success

400

{
  "code": 400,
  "message": "follow-up time must be in the future"
}

404

{
  "code": 404,
  "message": "contact not found"
}

401

{
  "code": 401,
  "message": "unauthorized"
}