curl --request POST \
  --url https://tapify.app/api/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fullName": "Alex Morgan"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({fullName: 'Alex Morgan'})
};

fetch('https://tapify.app/api/v1/contacts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "id": "f08f7c49-8f1e-42ac-b5ac-e0d6bd37d938",
    "workspaceId": "9df81bd4-3d76-42cc-9518-a019ea75a221",
    "fullName": "Alex Morgan",
    "jobTitle": "Sales Director",
    "company": "Northstar",
    "email": "alex@northstar.example",
    "mobile": "+31612345678",
    "phone": "<string>",
    "website": "https://northstar.example",
    "linkedin": "https://linkedin.com/in/alex-morgan",
    "address": "Amsterdam, Netherlands",
    "message": "Interested in a demo.",
    "internalNote": "Met at Tech Expo.",
    "captureMethod": "manual",
    "connectedWith": {
      "id": "45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7",
      "name": "Mina Park",
      "avatarUrl": "https://example.com/mina.jpg"
    },
    "tags": [
      {
        "name": "Follow up",
        "color": "neutral"
      }
    ],
    "details": [
      {
        "type": "email",
        "value": "alex@northstar.example",
        "isPrimary": true
      }
    ],
    "createdAt": "2026-07-28T09:30:00.000Z",
    "updatedAt": "2026-07-29T10:00:00.000Z",
    "enrichedAt": "2023-11-07T05:31:56Z",
    "created": true
  }
}

{
  "data": {
    "id": "f08f7c49-8f1e-42ac-b5ac-e0d6bd37d938",
    "workspaceId": "9df81bd4-3d76-42cc-9518-a019ea75a221",
    "fullName": "Alex Morgan",
    "jobTitle": "Sales Director",
    "company": "Northstar",
    "email": "alex@northstar.example",
    "mobile": "+31612345678",
    "phone": "<string>",
    "website": "https://northstar.example",
    "linkedin": "https://linkedin.com/in/alex-morgan",
    "address": "Amsterdam, Netherlands",
    "message": "Interested in a demo.",
    "internalNote": "Met at Tech Expo.",
    "captureMethod": "manual",
    "connectedWith": {
      "id": "45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7",
      "name": "Mina Park",
      "avatarUrl": "https://example.com/mina.jpg"
    },
    "tags": [
      {
        "name": "Follow up",
        "color": "neutral"
      }
    ],
    "details": [
      {
        "type": "email",
        "value": "alex@northstar.example",
        "isPrimary": true
      }
    ],
    "createdAt": "2026-07-28T09:30:00.000Z",
    "updatedAt": "2026-07-29T10:00:00.000Z",
    "enrichedAt": "2023-11-07T05:31:56Z",
    "created": true
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "fullName is required."
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "API key is invalid or revoked."
  }
}

{
  "error": {
    "code": "subscription_required",
    "message": "Tapify Teams Connect is required for this feature."
  }
}

{
  "error": {
    "code": "payload_too_large",
    "message": "Request body is too large."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "details": {
      "retryAfter": 30
    }
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong."
  }
}