UUpward API
v1
POST/api/public/v1/crm/create-call
Requires x-auth-token

Log a call

Schedule a phone call on a member's CRM calendar.

Creates a phone-call activity for one member of your company. Authenticate with your company API key in x-auth-token and identify the member with x-auth-user. Numbers in full international format (+13244345260) are stored as-is; a national number is accepted when you send phone_country as the two-letter ISO country code. This schedules the call — it does not dial anyone.

Body fields

titlestring (1–200)required

What the activity is called on the CRM calendar.

lead_iduuidoptional

The lead this activity belongs to. Send lead_id or contact_id — one is required.

contact_iduuidoptional

The contact this activity belongs to. Send lead_id or contact_id — one is required.

scheduled_atstring (ISO 8601)required

Start date and time, with an explicit UTC offset or Z.

duration_minutesnumber (1–1440)optional

Length in minutes. Defaults to 30.

prioritylow | normal | highoptional

Defaults to normal.

availabilitybusy | freeoptional

How the slot shows on the calendar. Defaults to busy.

notesstring (≤20000)optional

Free-text notes stored on the activity.

phone_numberstringrequired

The number to call. Use +country format, or send phone_country with a national number.

phone_countrystring (ISO 3166-1 alpha-2)optional

Country for a national number, e.g. US.

Responses

201CreatedThe call is scheduled on the member's CRM calendar.
{ "success": true, "error": "none", "activity_id": "0b1f0a2c-8f3e-4a51-9c0d-1c2b3a4d5e6f", "kind": "phone", "phone_number": "+13244345260" }
401UnauthorizedMissing or invalid x-auth-token, or a missing x-auth-user header.
{ "success": false, "error": "Missing x-auth-token header" }
404Member not foundNo active member in your company matches x-auth-user.
{ "success": false, "error": "No member matches "jane-doe" in this company." }
422Validation failedA field is missing or invalid, or the lead / contact does not belong to this member.
{ "success": false, "error": "Validation failed", "issues": ["scheduled_at: Use an ISO 8601 date and time, e.g. 2026-04-12T15:00:00Z"] }
POST/api/public/v1/crm/create-call

What the activity is called on the CRM calendar.

The lead this activity belongs to. Send lead_id or contact_id — one is required.

The contact this activity belongs to. Send lead_id or contact_id — one is required.

Start date and time, with an explicit UTC offset or Z.

Length in minutes. Defaults to 30.

Defaults to normal.

How the slot shows on the calendar. Defaults to busy.

Free-text notes stored on the activity.

The number to call. Use +country format, or send phone_country with a national number.

Country for a national number, e.g. US.

ResponseNot sent yet