Add or update a contact - zootools API documentation | email marketing, referral programs, viral waitlists, transactional emails.

[POST] Add or update a contact

It fails if the member was already added (email or cryptoAddress) — check the user before adding.

import zootools from 'zootools'

zootools.setApiToken("YOUR_ZOOTOOLS_API_KEY_FROM_THE_DASHBOARD")

const { contact, error } = await zootools.contacts.addOrUpdate({
    firstName: 'Jorge',
    lastName: 'Ferreiro',
    email: '[email protected]',
})

if (!error) {
    console.log('contact', contact)

    // (optional) if you need it, you can store in your database the contact id (contact.id) in case
    // you want to keep a reference of zootools contacts into your system
} else {
    console.log('error', error)
}


import axios from 'axios';

const endpoint = 'https://api.zootools.co/v1/audience/contacts';
const YOUR_ZOOTOOLS_API_TOKEN = 'your_api_token';

axios
    .post(endpoint, {
        firstName: 'Jorge',
        lastName: 'Ferreiro',
        email: '[email protected]',
    }, {
        headers: {
            Authorization: Bearer ${YOUR_ZOOTOOLS_API_TOKEN},
        }
    })
    .then((response) => {
        console.log(response.data); // prints out the new member
    })
    .catch((error) => {
        console.error(error); // there was an error...
    });

ENDPOINT
- https://audience-consumer-api.zootools.co/v1/lists/{id}/members

PARAMS
- listId*: string; // Get this id in the URL of the form.

PAYLOAD
// You must pass either an email, a cryptoAddress or both. One is required.
- email**: string;
- cryptoAddress**: string;
- referral: string; // memberId who referred the user.
- firstName: string;
- lastName: string;
- location: string;
- twitter: string;
- ... based on your form, you can pass extra values here.

HEADERS:
{
	headers: {
     Authorization: `Bearer API_TOKEN_YOU_GOT_FROM_US`,
  }
}

// **Either Email or cryptoAddress are required. You can pass an email,
// a wallet or both. If you don't pass any of them, the endpoint will raise
// a 400 invalid arguments

RESPONSE

{
	member: Member (member object),
  // Unique user identifier. You can use this to uniquely fetch a user.
	jsonWebToken: string;
}

ERRORS

// Anti BOTS!
// If the user is banned in our system or it's a bot you will receive this.
// If the user is using a temporary email address it will also raise this error.
{
  "statusCode": 401,
  "error": "Bad Request",
  "message": "lists/user_banned"
}

// If no parameters are provided
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "lists/email_or_crypto_address_required"
}

// User already exists in the database (either via email or contractAddress)
{
  "statusCode": 400,
  "error": "Not Found",
  "message": "lists/already_member"
}

// NOT found list. most likely you pass a wrong listId
{
  "statusCode": 404,
  "error": "Not Found",
  "message": "lists/not_found"
}

// Internal error. Try again.
{
  "statusCode": 500,
  "error": "Internal error",
  "message": "lists/adding_member_internal_error"
}

Properties

name

string

required

Name of your project. Used for the global title.Example: mintlify

An array of groups with all the pages within that group

Show Navigation

group

string

The name of the group.Example: Settings

pages

string[]

The relative paths to the markdown files that will serve as pages.Example: ["customization", "page"]

logo

string or object

Path to logo image or object with path to “light” and “dark” mode logo images

Show Logo

light

string

Path to the logo in light mode

dark

string

Path to the logo in dark mode

href

string

default:"/"

Where clicking on the logo links you to

favicon

string

Path to the favicon image

colors

Colors

Hex color codes for your global theme

Show Colors

primary

string

required

The primary color. Used for most often for highlighted content, section headers, accents, in light mode

light

string

The primary color for dark mode. Used for most often for highlighted content, section headers, accents, in dark mode

dark

string

The primary color for important buttons

background

object

The color of the background in both light and dark mode

Show Object

light

string

required

The hex color code of the background in light mode

dark

string

required

The hex color code of the background in dark mode

topbarLinks

TopbarLink[]

Array of names and urls of links you want to include in the topbar

Show TopbarLink

name

string

The name of the button.Example: Contact us

url

string

The url once you click on the button. Example: https://mintlify.com/contact

topbarCtaButton

Call to Action

Show Topbar Call to Action

type

"link" or "github"

default:"link"

Link shows a button. GitHub shows the repo information at the url provided including the number of GitHub stars.

url

string

If link: What the button links to.If github: Link to the repository to load GitHub information from.

name

string

Text inside the button. Only required if type is a link.

versions

string[]

Array of version names. Only use this if you want to show different versions of docs with a dropdown in the navigation bar.

anchors

Anchor[]

An array of the anchors, includes the icon, color, and url.

Show Anchor

icon

string

The Font Awesome icon used to feature the anchor.Example: comments

name

string

The name of the anchor label.Example: Community

url

string

The start of the URL that marks what pages go in the anchor. Generally, this is the name of the folder you put your pages in.

color

string

The hex color of the anchor icon background. Can also be a gradient if you pass an object with the properties from and to that are each a hex color.

version

string

Used if you want to hide an anchor until the correct docs version is selected.

isDefaultHidden

boolean

default:"false"

Pass true if you want to hide the anchor until you directly link someone to docs inside it.

iconType

string

default:"duotone"

One of: “brands”, “duotone”, “light”, “sharp-solid”, “solid”, or “thin”

topAnchor

Object

Override the default configurations for the top-most anchor.

Show Object

name

string

default:"Documentation"

The name of the top-most anchor

icon

string

default:"book-open"

Font Awesome icon.

iconType

string

default:"duotone"

One of: “brands”, “duotone”, “light”, “sharp-solid”, “solid”, or “thin”

tabs

Tabs[]

An array of navigational tabs.

Show Tabs

name

string

The name of the tab label.

url

string

The start of the URL that marks what pages go in the tab. Generally, this is the name of the folder you put your pages in.

api

API

Configuration for API settings. Learn more about API pages at API Components.

Show API

baseUrl

string

The base url for all API endpoints. If baseUrl is an array, it will enable for multiple base url options that the user can toggle.

auth

Auth

Show Auth

method

"bearer" | "basic" | "key"

The authentication strategy used for all API endpoints.

name

string

The name of the authentication parameter used in the API playground.If method is basic, the format should be [usernameName]:[passwordName]

inputPrefix

string

The default value that’s designed to be a prefix for the authentication input field.E.g. If an inputPrefix of AuthKey would inherit the default input result of the authentication field as AuthKey.

playground

Playground

Configurations for the API playground

Show Playground

mode

"show" | "simple" | "hide"

default:"show"

Whether the playground is showing, hidden, or only displaying the endpoint with no added user interactivity simpleLearn more at the playground guides

maintainOrder

boolean

Enabling this flag ensures that key ordering in OpenAPI pages matches the key ordering defined in the OpenAPI file.

This behavior will soon be enabled by default, at which point this field will be deprecated.

openapi

string | string[]

A string or an array of strings of URL(s) or relative path(s) pointing to your OpenAPI file.Examples:

"openapi": "https://example.com/openapi.json"

footerSocials

FooterSocials

An object of social media accounts where the key:property pair represents the social media platform and the account url.Example:

{
  "twitter": "https://twitter.com/mintlify",
  "website": "https://mintlify.com"
}

Show FooterSocials

[key]

string

One of the following values website, facebook, twitter, discord, slack, github, linkedin, instagram, hacker-newsExample: twitter

property

string

The URL to the social platform.Example: https://twitter.com/mintlify

feedback

Feedback

Configurations to enable feedback buttons

Show Feedback

suggestEdit

boolean

default:"false"

Enables a button to allow users to suggest edits via pull requests

raiseIssue

boolean

default:"false"

Enables a button to allow users to raise an issue about the documentation

modeToggle

ModeToggle

Customize the dark mode toggle.

Show ModeToggle

default

"light" or "dark"

Set if you always want to show light or dark mode for new users. When not set, we default to the same mode as the user’s operating system.

isHidden

boolean

default:"false"

Set to true to hide the dark/light mode toggle. You can combine isHidden with default to force your docs to only use light or dark mode. For example:

"modeToggle": {
  "default": "dark",
  "isHidden": true
}

backgroundImage

string

A background image to be displayed behind every page. See example with Infisical and FRPC.

​[POST] Add or update a contact

​Properties

[POST] Add or update a contact

Properties