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

Log an email

Add an email activity to a member's CRM calendar.

Creates an email 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. The email is recorded on the CRM calendar for the member to review and send — this endpoint never sends mail on their behalf.

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.

subjectstring (1–300)required

Email subject line.

messagestring (1–20000)required

Email body.

toarray of stringrequired

1–20 recipient email addresses.

ccarray of stringoptional

Up to 20 cc addresses.

bccarray of stringoptional

Up to 20 bcc addresses.

Responses

201CreatedThe email activity is on the member's CRM calendar; nothing was sent.
{ "success": true, "error": "none", "activity_id": "0b1f0a2c-8f3e-4a51-9c0d-1c2b3a4d5e6f", "kind": "email", "sent": false }
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-email

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.

Email subject line.

Email body.

1–20 recipient email addresses.

Up to 20 cc addresses.

Up to 20 bcc addresses.

ResponseNot sent yet