Create multiple contacts

POST

https://app.trypeach.io/api/v1/contacts

Create a contact

Request

Authorization

Add parameter in header

Authorization

Example:

Authorization: ********************

Body Params application/json

Example

[
    {
        "name": "Alfred Hitchcock",
        "email": "alfred@example.com",
        "phone_number": "+19019019191 or +919876543210",
        "metadata": {
            "source": "website",
            "location": "bangalore"
        }
    },
    {
        "name": "Stanley Kubrick",
        "email": "stanley@example.com",
        "phone_number": "+14155552671 or +919876543211",
        "metadata": {
            "source": "referral",
            "location": "mumbai"
        }
    },
    {
        "name": "Akira Kurosawa",
        "email": "akira@example.com",
        "phone_number": "+81345678901 or +919876543212",
        "metadata": {
            "source": "website",
            "location": "delhi"
        }
    },
    {
        "name": "Satyajit Ray",
        "email": "satyajit@example.com",
        "phone_number": "+913324176666 or +919876543213",
        "metadata": {
            "source": "app",
            "location": "kolkata"
        }
    },
    {
        "name": "Ingmar Bergman",
        "email": "ingmar@example.com",
        "phone_number": "+46812345678 or +919876543214",
        "metadata": {
            "source": "referral",
            "location": "chennai"
        }
    }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://app.trypeach.io/api/v1/contacts' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "name": "Alfred Hitchcock",
        "email": "alfred@example.com",
        "phone_number": "+19019019191 or +919876543210",
        "metadata": {
            "source": "website",
            "location": "bangalore"
        }
    },
    {
        "name": "Stanley Kubrick",
        "email": "stanley@example.com",
        "phone_number": "+14155552671 or +919876543211",
        "metadata": {
            "source": "referral",
            "location": "mumbai"
        }
    },
    {
        "name": "Akira Kurosawa",
        "email": "akira@example.com",
        "phone_number": "+81345678901 or +919876543212",
        "metadata": {
            "source": "website",
            "location": "delhi"
        }
    },
    {
        "name": "Satyajit Ray",
        "email": "satyajit@example.com",
        "phone_number": "+913324176666 or +919876543213",
        "metadata": {
            "source": "app",
            "location": "kolkata"
        }
    },
    {
        "name": "Ingmar Bergman",
        "email": "ingmar@example.com",
        "phone_number": "+46812345678 or +919876543214",
        "metadata": {
            "source": "referral",
            "location": "chennai"
        }
    }
]'

Responses

🟢201Created

application/json

Created a contact successfully

Body

Example

{
    "name": "Alfred Hitchcock",
    "language": "string",
    "email": "alfred@example.com",
    "phone_number": "+919988776655",
    "metadata": {
        "key": "value"
    }
}

🟠422Parameter Error

Modified at 2026-04-21 12:14:00

Close Conversation

Update a contact