curl -X POST https://api.guayaba.ai/contacts/fulfill \
-H "Content-Type: application/json" \
-H "X-API-Key: gua_a1b2c3d4_your-api-key-here" \
-d '{
"phone": "+11234567890"
}'
const response = await fetch('https://api.guayaba.ai/contacts/fulfill', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'gua_a1b2c3d4_your-api-key-here'
},
body: JSON.stringify({
phone: '+11234567890'
})
});
const data = await response.json();
import requests
response = requests.post(
'https://api.guayaba.ai/contacts/fulfill',
headers={
'Content-Type': 'application/json',
'X-API-Key': 'gua_a1b2c3d4_your-api-key-here'
},
json={
'phone': '+11234567890'
}
)
data = response.json()
{
"success": true,
"message": "Contact marked as fulfilled successfully"
}
{
"error": "Validation error",
"message": "Invalid phone number"
}
{
"error": "Not found",
"message": "Contact not found"
}
Contacts
Fulfill Contact
Mark a contact as fulfilled by phone number.
POST
/
contacts
/
fulfill
curl -X POST https://api.guayaba.ai/contacts/fulfill \
-H "Content-Type: application/json" \
-H "X-API-Key: gua_a1b2c3d4_your-api-key-here" \
-d '{
"phone": "+11234567890"
}'
const response = await fetch('https://api.guayaba.ai/contacts/fulfill', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'gua_a1b2c3d4_your-api-key-here'
},
body: JSON.stringify({
phone: '+11234567890'
})
});
const data = await response.json();
import requests
response = requests.post(
'https://api.guayaba.ai/contacts/fulfill',
headers={
'Content-Type': 'application/json',
'X-API-Key': 'gua_a1b2c3d4_your-api-key-here'
},
json={
'phone': '+11234567890'
}
)
data = response.json()
{
"success": true,
"message": "Contact marked as fulfilled successfully"
}
{
"error": "Validation error",
"message": "Invalid phone number"
}
{
"error": "Not found",
"message": "Contact not found"
}
Marks a contact as fulfilled by their phone number. This cancels all scheduled outreach (calls, SMS, WhatsApp messages, and triggers) and sets the contact’s status to
fulfilled.
This endpoint requires an
X-API-Key header. See Authentication for details.Request Body
string
required
Phone number of the contact to fulfill, in E.164 format (e.g.,
+11234567890).Behavior Notes
Scheduled outreach is cancelled
Scheduled outreach is cancelled
All pending calls, SMS, WhatsApp messages, and triggers for this contact are immediately cancelled.
Fulfilled timestamp
Fulfilled timestamp
The contact’s status is set to
fulfilled and the fulfilledAt timestamp is recorded automatically.Response
boolean
Always
true on a successful request.string
Human-readable confirmation message.
curl -X POST https://api.guayaba.ai/contacts/fulfill \
-H "Content-Type: application/json" \
-H "X-API-Key: gua_a1b2c3d4_your-api-key-here" \
-d '{
"phone": "+11234567890"
}'
const response = await fetch('https://api.guayaba.ai/contacts/fulfill', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'gua_a1b2c3d4_your-api-key-here'
},
body: JSON.stringify({
phone: '+11234567890'
})
});
const data = await response.json();
import requests
response = requests.post(
'https://api.guayaba.ai/contacts/fulfill',
headers={
'Content-Type': 'application/json',
'X-API-Key': 'gua_a1b2c3d4_your-api-key-here'
},
json={
'phone': '+11234567890'
}
)
data = response.json()
{
"success": true,
"message": "Contact marked as fulfilled successfully"
}
{
"error": "Validation error",
"message": "Invalid phone number"
}
{
"error": "Not found",
"message": "Contact not found"
}