curl -X POST "https://api.tracklysms.com/api/v2/contacts" \
  -H "X-Api-Key: trk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+14155559876",
    "list_number": "+18005551234",
    "use_journeys": true,
    "custom_fields": {
      "first_name": "Jane",
      "source": "landing_page_v2"
    },
    "ip_address": "203.0.113.42",
    "url": "https://example.com/signup"
  }'

import requests

response = requests.post(
    "https://api.tracklysms.com/api/v2/contacts",
    headers={
        "X-Api-Key": "trk_your_api_key_here",
        "Content-Type": "application/json"
    },
    json={
        "phone_number": "+14155559876",
        "list_number": "+18005551234",
        "use_journeys": True,
        "custom_fields": {
            "first_name": "Jane",
            "source": "landing_page_v2"
        },
        "ip_address": "203.0.113.42",
        "url": "https://example.com/signup"
    }
)

data = response.json()
print(f"New contact: {data['is_new_contact']}")
print(f"Journeys enrolled: {data['journeys_enrolled']}")

const response = await fetch("https://api.tracklysms.com/api/v2/contacts", {
  method: "POST",
  headers: {
    "X-Api-Key": "trk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phone_number: "+14155559876",
    list_number: "+18005551234",
    use_journeys: true,
    custom_fields: {
      first_name: "Jane",
      source: "landing_page_v2",
    },
    ip_address: "203.0.113.42",
    url: "https://example.com/signup",
  }),
});

const data = await response.json();
console.log("New contact:", data.is_new_contact);
console.log("Journeys enrolled:", data.journeys_enrolled);

{
  "success": true,
  "contact_id": "665a1b2c3d4e5f6a7b8c9d0e",
  "list_contact_id": "665a1b2c3d4e5f6a7b8c9d0f",
  "is_new_contact": true,
  "is_new_list_contact": true,
  "journeys_enrolled": 1
}

{
  "success": true,
  "resubscribed": true,
  "contact_id": "665a1b2c3d4e5f6a7b8c9d0e",
  "list_contact_id": "665a1b2c3d4e5f6a7b8c9d0f",
  "is_new_contact": false,
  "is_new_list_contact": false,
  "journeys_enrolled": 0,
  "carrier_status": "cleared"
}

{
  "success": true,
  "contact_id": "665a1b2c3d4e5f6a7b8c9d0e",
  "list_contact_id": "665a1b2c3d4e5f6a7b8c9d0f",
  "is_new_contact": false,
  "is_new_list_contact": false,
  "journeys_enrolled": 0,
  "skipped": true,
  "skip_reason": "previously_unsubscribed"
}

{
  "error": "phone_number is required",
  "code": "missing_phone_number"
}

{
  "error": "Invalid E.164 phone number format",
  "code": "invalid_phone"
}

{
  "error": "Sending list not found for this list_number",
  "code": "list_not_found"
}

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