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 namelast_name
(optional): Contact's last nameemail
(optional*): Contact's email address for review requestmobile_phone_number
(optional*): Contact's phone for SMS review requestcompany_name
(optional): Contact's company namedelay_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:
- Checks if the contact already exists (deduplication)
- Schedules the review request based on
delay_hours
- Automatically sends the request at the optimal time
- 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);