Contacts API Reference

Complete API reference for managing contacts programmatically.

Base URL
https://wapify.me/api/team/contacts
Authentication

All requests require Bearer token authentication. Include the token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN
Available Endpoints
Quick Navigation
GET List Contacts
https://wapify.me/api/team/contacts

Retrieve a paginated list of contacts.

Query Parameters
Parameter Tipo Descripción
page integer Page number (default: 1)
per_page integer Items per page (default: 15)
search string Search term for name, email, or company
category_id integer Filter by category ID
Example Request
curl -X GET "https://wapify.me/api/team/contacts?page=1&per_page=10&search=john" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
Response
{
  "data": [
    {
      "id": 1,
      "name": "John Doe",
      "email": "john@example.com",
      "phone": "+1234567890",
      "company": "Example Corp",
      "category": {
        "id": 1,
        "name": "Customer"
      },
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 10,
    "total": 25,
    "last_page": 3
  }
}
GET Get Contact
https://wapify.me/api/team/contacts/{id}

Retrieve a single contact by ID.

Example Request
curl -X GET "https://wapify.me/api/team/contacts/1" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
POST Create Contact
https://wapify.me/api/team/contacts

Create a new contact.

Request Body
Field Tipo Required Descripción
name string Sí Contact full name
surname string No Contact surname/last name
email string No* Contact email address (required if no phone)
phone string No* Contact phone number (required if no email)
category_id integer No Category ID (single category)
category_ids array No Array of category IDs (multiple categories)
Example Request
curl -X POST "https://wapify.me/api/team/contacts" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "Jane Smith",
    "surname": "Doe",
    "email": "jane@example.com",
    "phone": "+1987654321",
    "category_id": 433
  }'
PUT Update Contact
https://wapify.me/api/team/contacts/{id}

Update an existing contact. Only include fields you want to update.

Example Request
curl -X PUT "https://wapify.me/api/team/contacts/1" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "phone": "+1555123456",
    "company": "Updated Company Name"
  }'
DELETE Delete Contact
https://wapify.me/api/team/contacts/{id}

Delete a contact. This action cannot be undone.

Example Request
curl -X DELETE "https://wapify.me/api/team/contacts/1" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
GET Search Contacts
https://wapify.me/api/team/contacts/search

Advanced search functionality.

Query Parameters
Parameter Tipo Descripción
q string Search query (name, email, company)
limit integer Maximum results (default: 10)
Example Request
curl -X GET "https://wapify.me/api/team/contacts/search?q=john&limit=5" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
Back to Authentication Back to API Overview