Create Citizen Contacts

Adds contacts to the specified citizen user. Include the contact IDs to be added in the request array.

Resource Information

Scopeusers

Deprecated scope name:   create_citizenaccess_citizens_contacts

App TypeAll
Authorization TypeAccess token
URI /v4/citizenaccess/citizens/{id}/contacts?lang={lang}
HTTP MethodPOST
Automation Version(s)7.3.3.4

Request Information

Field or ParameterTypeRequiredValuesDescriptionAutomation Version
contactIdsstringYesAn array containing the contact IDs.7.3.3.4
idstringYesThe unique identifier for the object, assigned by the Civic Platform server and provided in a response.7.3.3.4
langStringNoIndicates the language applied.7.3.3.4

Example

Sample Request Head

POST https://apis.accela.com/v4/citizenaccess/citizens/8661/contacts

Sample Request Body

[
  "912"
]

Notes

This example assumes the logged-in user is an authorized agent.

Response Information

FieldTypeDescriptionAutomation Version
resultresult{}7.3.3.4
result.failedCountlongThe number of failed results.7.3.3.4
result.failedIDsstringThe IDs of the entities on which the operation failed.7.3.3.4
result.successCountlongThe number of successful results.7.3.3.4
result.successIDsstringThe IDs of the entities on which the operation succeeded.7.3.3.4
statusintegerThe record status.7.3.3.4

Example

Sample Response Body

{
  "status": 200,
  "result": {
    "successCount": 1,
    "failedCount": 0,
    "failedIDs": []
  }
}