Update Contact

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

Set the funnel stage, tags and note of a contact. Every field is required and replaces the current value, so send the current tags and note along when you only change the stage.

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
stage	string	Yes	Funnel stage: new, contacted, interested, won, or lost.
tags	array	Yes	Every tag of the contact, at most 20 of up to 30 characters. Replaces the current tags; duplicates that differ only in case are kept once.
note	string	Yes	Free note about the contact, up to 2000 characters. Send "" for no note.

Example Request

cURL

curl -X PUT "https://api.repliz.com/public/contact/690a1f3ce12f2f72916f67e1" \
  -H "Authorization: Basic $(echo -n 'YOUR_ACCESS_KEY:YOUR_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "stage": "interested",
    "tags": ["reseller", "jakarta"],
    "note": "Asked for the reseller price list."
  }'

Axios

import axios from 'axios';

const contactId = '690a1f3ce12f2f72916f67e1';

const response = await axios.put(
  `https://api.repliz.com/public/contact/${contactId}`,
  {
    stage: 'interested',
    tags: ['reseller', 'jakarta'],
    note: 'Asked for the reseller price list.',
  },
  {
    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}`, {
  method: 'PUT',
  headers: {
    Authorization: `Basic ${credentials}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    stage: 'interested',
    tags: ['reseller', 'jakarta'],
    note: 'Asked for the reseller price list.',
  }),
});

console.log(response.status);

Response

204

// No content returned on success

404

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

401

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