POST
/
metadata-ingestion
/
v1
/
single-customer-metadata
curl --request POST \
  --url https://api.sandbox.asapp.com/metadata-ingestion/v1/single-customer-metadata \
  --header 'Content-Type: application/json' \
  --header 'asapp-api-id: <api-key>' \
  --header 'asapp-api-secret: <api-key>' \
  --data '{
  "externalConversationId": "id-509",
  "externalCustomerId": "555.555.0100-jdoe@example.com",
  "eventId": "eventId-1938",
  "status": "new",
  "phoneNumber": "(555)555-0100",
  "emailAddress": "jdoe@example.com",
  "userId": "user908038",
  "addressCountry": "United-States",
  "addressState": "New-York",
  "addressZipcode": "10001",
  "attributes": [
    {
      "name": "attr1_name",
      "value": "attr1_value"
    },
    {
      "name": "attr2_name",
      "value": "attr2_value"
    }
  ]
}'
{
  "result": {
    "eventId": "5484e507-feaf-11ec-bfc1-fda566fa9333",
    "error": "FAIL_BAD_PARAMS: ERROR: agent id cannot be blank"
  }
}

Authorizations

​
asapp-api-id
string
header
required
​
asapp-api-secret
string
header
required

Body

application/json

A set of customer metadata attributes

​
externalConversationId
string
required

Conversation ID from the external chat / voice system

Maximum length: 256
​
externalCustomerId
string
required

The customer id involved in respect to the issue in question

Maximum length: 256
​
eventId
string | null

An event id used to track the submission; if none is provided, service will generate one

Maximum length: 256
​
status
string | null

The descriptive label to describe the customer's status and/or type

Maximum length: 256
​
phoneNumber
string | null

The customer's phone number

Maximum length: 32
​
emailAddress
string | null

The customer's email address

​
userId
string | null

The customer's user Id

Maximum length: 256
​
addressCountry
string | null

The country portion of the customer's address

Maximum length: 128
​
addressState
string | null

The state portion of the customer's address

Maximum length: 128
​
addressZipcode
string | null

The zipcode/postal code portion of the customer's address

Maximum length: 16
​
attributes
object[] | null

A map of key-value pairs for extra metadata attributes

Response

200
application/json
200 - Success Submit a single item to the service to be ingested. Record can be traced back to the submitted record by the eventId. A message sent status will be returned with no error message for successful input checks.
​
result
object
required

A response with the status of a sent message

Was this page helpful?

Add multiple conversation metadataAdd multiple customer metadata