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.

How it works

  • Authenticate with your company API key in x-auth-token.
  • Identify the member with x-auth-user (their pagename or your own external_id).
  • Link it to a lead or contact: send lead_id or contact_id (one is required).
  • Numbers in full international format (e.g. +13244345260) are stored as-is.
  • A national number is accepted when you also send phone_country (two-letter ISO code, e.g. US).

Good to know

  • This schedules the call only — 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