curl -X POST "https://api.tracklysms.com/api/v2/contacts/bulk" \
  -H "X-Api-Key: trk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      {
        "phone_number": "+14155559876",
        "list_number": "+18005551234",
        "use_journeys": true,
        "custom_fields": {"first_name": "Jane"}
      },
      {
        "phone_number": "+12125551000",
        "list_number": "+18005551234",
        "custom_fields": {"first_name": "John"}
      },
      {
        "phone_number": "+13105558888",
        "list_number": "+18005551234",
        "signup_date": "2025-03-10T08:00:00Z",
        "ip_address": "198.51.100.17"
      }
    ]
  }'

import requests

contacts = [
    {
        "phone_number": "+14155559876",
        "list_number": "+18005551234",
        "use_journeys": True,
        "custom_fields": {"first_name": "Jane"}
    },
    {
        "phone_number": "+12125551000",
        "list_number": "+18005551234",
        "custom_fields": {"first_name": "John"}
    },
    {
        "phone_number": "+13105558888",
        "list_number": "+18005551234",
        "signup_date": "2025-03-10T08:00:00Z",
        "ip_address": "198.51.100.17"
    }
]

response = requests.post(
    "https://api.tracklysms.com/api/v2/contacts/bulk",
    headers={
        "X-Api-Key": "trk_your_api_key_here",
        "Content-Type": "application/json"
    },
    json={"contacts": contacts}
)

data = response.json()
print(f"Created: {data['success_count']}, Errors: {data['error_count']}")

for error in data.get("errors", []):
    print(f"  Index {error['index']}: {error['code']} - {error['error']}")

const contacts = [
  {
    phone_number: "+14155559876",
    list_number: "+18005551234",
    use_journeys: true,
    custom_fields: { first_name: "Jane" },
  },
  {
    phone_number: "+12125551000",
    list_number: "+18005551234",
    custom_fields: { first_name: "John" },
  },
  {
    phone_number: "+13105558888",
    list_number: "+18005551234",
    signup_date: "2025-03-10T08:00:00Z",
    ip_address: "198.51.100.17",
  },
];

const response = await fetch(
  "https://api.tracklysms.com/api/v2/contacts/bulk",
  {
    method: "POST",
    headers: {
      "X-Api-Key": "trk_your_api_key_here",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ contacts }),
  }
);

const data = await response.json();
console.log(`Created: ${data.success_count}, Errors: ${data.error_count}`);

{
  "success_count": 2,
  "error_count": 1,
  "errors": [
    {
      "index": 2,
      "phone_number": "3105558888",
      "code": "invalid_phone",
      "error": "Invalid E.164 phone number format"
    }
  ],
  "contacts_created": 2,
  "list_contacts_created": 2,
  "journeys_enrolled": 1
}

{
  "success_count": 3,
  "error_count": 0,
  "errors": [],
  "contacts_created": 3,
  "list_contacts_created": 3,
  "journeys_enrolled": 0
}

{
  "error": "contacts array is required",
  "code": "missing_contacts"
}

{
  "error": "Maximum 1000 contacts per request",
  "code": "too_many_contacts"
}

{
  "error": "Maximum 500 contacts with use_validation=true per request",
  "code": "too_many_contacts_with_validation"
}

{
  "error": "Maximum 100 contacts with double_optin=true per request",
  "code": "too_many_contacts_with_double_optin"
}

{
  "error": "An active payment method is required when use_validation=true",
  "code": "no_payment_method"
}