Skip to main content

Add Contact (Send Review Request)

Adds a contact to Nudge, which automatically triggers a review request. There's no separate "send" action - it's all automatic!

Endpoint

POST /api/zapier/send-review-request

Headers

Authorization: Bearer your-access-token
Content-Type: application/json

Request Body

{
"first_name": "Jane",
"last_name": "Smith",
"email": "jane@example.com",
"mobile_phone_number": "+12125551234",
"company_name": "Smith Industries",
"delay_hours": 24,
"metadata": {
"source": "zapier",
"job_id": "12345"
}
}

Remember: When you add this contact, Nudge automatically sends the review request. You don't need to do anything else!

Field Descriptions

  • first_name (optional): Contact's first name
  • last_name (optional): Contact's last name
  • email (optional*): Contact's email address for review request
  • mobile_phone_number (optional*): Contact's phone for SMS review request
  • company_name (optional): Contact's company name
  • delay_hours (optional): Hours to wait before automatically sending (default: 0)
  • metadata (optional): Track where this contact came from

*At least one of email or mobile_phone_number is required

Response

{
"id": "770e8400-e29b-41d4-a716-446655440000",
"contact_id": "880e8400-e29b-41d4-a716-446655440000",
"contact_name": "Jane Smith",
"contact_email": "jane@example.com",
"contact_phone": "+12125551234",
"scheduled_for": "2024-01-02T12:00:00Z",
"status": "scheduled",
"message": "Review request scheduled for jane@example.com"
}

How It Works Behind the Scenes

Automatic Review Request Sending

When you add a contact through this endpoint, Nudge:

  1. Checks if the contact already exists (deduplication)
  2. Schedules the review request based on delay_hours
  3. Automatically sends the request at the optimal time
  4. Handles all follow-ups automatically

Phone Number Format

Phone numbers should be provided in E.164 format (e.g., +12125551234). The API will attempt to normalize phone numbers, but E.164 format is recommended for best results.

Contact Deduplication

If a contact already exists with the same email or phone number, the existing contact will be updated, and duplicate review requests are prevented.

Example Usage

cURL

curl -X POST https://app.justanudge.co/api/zapier/send-review-request \
-H "Authorization: Bearer your-access-token" \
-H "Content-Type: application/json" \
-d '{
"first_name": "Jane",
"last_name": "Smith",
"email": "jane@example.com",
"delay_hours": 24
}'

JavaScript

const response = await fetch('https://app.justanudge.co/api/zapier/send-review-request', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-access-token',
'Content-Type': 'application/json',
},
body: JSON.stringify({
first_name: 'Jane',
last_name: 'Smith',
email: 'jane@example.com',
delay_hours: 24
})
});

const data = await response.json();
console.log(data);