S
Samva
S
Samva
DashboardAPISamva DocumentationQuickstart GuideAuthentication

API Reference

Email Management

Conversation Management

Create ConversationGet ConversationList ConversationsAdd Participants to ConversationRemove Participants from ConversationUpdate Conversation

Configuration

Analytics & Operations

OpenAPI Specification
API ReferenceConversations

Create Conversation

POST
/conversations

Authorization

apiKey
X-API-Key<token>

API key for authentication

In: header

Request Body

application/json

title?string|null
description?string|null
externalId?string|null
parentConversationId?string|null
channels*array<unknown>
primaryChannel*unknown
Value in"sms" | "whatsapp" | "email"
status?unknown
Value in"active" | "waiting" | "resolved" | "escalated" | "archived"
statusReason?string|null
priority?integer
Range-2147483648 <= value <= 2147483647
urgency?unknown
Value in"low" | "medium" | "high" | "critical"
complexity?unknown
Value in"simple" | "moderate" | "complex"
metadata?|null
participantTracking*||
metrics?||
context?|null
tags?array<string>
categories?array<string>
isTest?boolean
isInternal?boolean
isPrivate?boolean
lastActivityAt?string
Formatdate-time
lastHumanActivityAt?string|null
resolvedAt?string|null
archivedAt?string|null
resolvedBy?string|null
resolutionType?unknown|null
resolutionNotes?string|null
createdBy?string|null
participantIds*array<string>
Items1 <= items

Response Body

application/json

curl -X POST "https://samva.app/api/v1/conversations" \  -H "Content-Type: application/json" \  -d '{    "channels": [      "sms"    ],    "primaryChannel": "sms",    "participantTracking": "string",    "participantIds": [      "497f6eca-6276-4993-bfeb-53cbbbba6f08"    ]  }'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "organizationId": "7bc05553-4b68-44e8-b7bc-37be63c6d9e9",
  "title": "string",
  "description": "string",
  "externalId": "string",
  "parentConversationId": "2314ba74-0ed2-497a-9dc0-620a31a0f6d4",
  "channels": [
    "sms"
  ],
  "primaryChannel": "sms",
  "status": "active",
  "statusReason": "string",
  "priority": -2147483648,
  "urgency": "low",
  "complexity": "simple",
  "metadata": "string",
  "participantTracking": "string",
  "metrics": "string",
  "context": "string",
  "tags": [
    "string"
  ],
  "categories": [
    "string"
  ],
  "isTest": true,
  "isInternal": true,
  "isPrivate": true,
  "startedAt": "2019-08-24T14:15:22Z",
  "lastActivityAt": "2019-08-24T14:15:22Z",
  "lastHumanActivityAt": "2019-08-24T14:15:22Z",
  "resolvedAt": "2019-08-24T14:15:22Z",
  "archivedAt": "2019-08-24T14:15:22Z",
  "resolvedBy": "14b2aa2a-efb0-4ef1-9ffc-3025efbd2222",
  "resolutionType": "automated",
  "resolutionNotes": "string",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "createdBy": "25a02396-1048-48f9-bf93-102d2fb7895e"
}

Send Message

Previous Page

Get Conversation

Next Page

curl -X POST "https://samva.app/api/v1/conversations" \
  -H "Content-Type: application/json" \
  -d '{
    "channels": [
      "sms"
    ],
    "primaryChannel": "sms",
    "participantTracking": "string",
    "participantIds": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
  }'