POST: Create and update a unified profile

POST /api/v1/identities

An API that allows you to create and update your customer's integrated profile.

Query parameters

Name	Whether required	Type	Explanation
service_id	Essential	String	Service ID

Header

Field name	Whether required	Type	Value	Explanation
Content-Type	Essential	String	application/json	-
access_token	Essential	String	your-api-token-key	API Authentication Token

Request body

Field name	Whether required	Type	Explanation
identity	Essential	Object	Common properties for event loading
request_datetime	Essential	Datetime	Request Time, ISODate 8601 Format, 2024-06-24T06:42:25.394Z

Identity

User identification information. You must enter a value in at least one of the fields below.

Field name	Whether required	Type	Explanation
external_id	Select	String	External ID
phone_no	Select	String	Phone number
email	Select	String	Email
kakao_user_id	Select	String	Kakao ID
line_user_id	Select	String	Line ID

Example request

curl -L \
  -X POST \
  -H 'access_token: ${your-import-api-token}' \
  -H 'Content-Type: application/json' \
  'https://openapi.dfinery.ai/api/v1/identities?service_id=${your-service-id}' \
  -d '{
   "identity":{
      "external_id": "dfn-user-123",
      "email": "[email protected]",
      "phone_no": "821012345678"
   },
   "request_datetime":"2024-06-24T06:01:48.501Z"
  }
 '

Example response

Normal response

Content-Type: application/json
access_token: text
{
  "status": true,
  "code": "20000",
  "message": "OK",
  "data": true
}

Failure response

Please refer to the detailed response for more details.