Create Thread | propelone

Creates or reuses a Thread via ThreadResolver. Identity = (tenant, location, channel, related_*, participant-set hash).

{{tenant_key_name}}stringOptional

This endpoint expects a multipart form.

channelstringRequired

Required: Primary channel - sms|voice|email|in_app_chat|push

subjectstringRequired

Optional: Thread subject - max 255 chars

visibilitystringRequired

Required: Thread visibility - customer_facing|internal_only

participants[0][email]stringRequired

Optional: Email for email channel

participants[0][phone_e164]stringRequired

Optional: E.164 phone for SMS/voice channel

participants[1][phone_e164]stringRequired

Optional: E.164 phone for second participant

participants[0][display_name]stringRequired

Optional: Display name for the participant

participants[1][display_name]stringRequired

Optional: Display name for second participant

participants[0][participant_type]stringRequired

Required: Participant type - customer|technician|backoffice_user|automated|external

participants[1][participant_type]stringRequired

Required: Participant type for second participant

Successful response

1	curl -X POST https://https//https/communications/threads \
2	-H "{{tenant_key_name}}: {{tenant_key_value1}}\|{{tenant_key_value2}}" \
3	-H "Content-Type: multipart/form-data" \
4	-F channel="sms" \
5	-F subject="Order Inquiry" \
6	-F visibility="customer_facing" \
7	-F participants[0][email]="customer@example.com" \
8	-F participants[0][phone_e164]="+14155552671" \
9	-F participants[1][phone_e164]="+14155559876" \
10	-F participants[0][display_name]="Jane Doe" \
11	-F participants[1][display_name]="Support Agent" \
12	-F participants[0][participant_type]="customer" \
13	-F participants[1][participant_type]="technician"