This method updates an existing user record and returns the record's unique identifier. The list of fields that can be updated is customizable for each organization and is different for administrative and non-administrative users. The fields that can be updated by the caller can be retrieved using the listUserFields API method.
Client Servlet | Server Servlet | HTTP Methods Supported | Requires Authentication |
---|---|---|---|
CRConsAPI | SRConsAPI | POST | Yes. |
This method attempts to locate and update an existing constituent record in the Luminate Online Constituent 360 database using the value of the cons_id, member_id, or primary_email parameters to locate the record.
The list of constituent record fields that can be set is customizable for each organization. It is different for administrative users (via the Client or Server API) and non-administrative users (via Client API).
listUserFields will return the list of the Constituent record fields the caller may update.
This method automatically invokes logInteraction to log an interaction for the target constituent.
See topic Common Parameters.
Optional. Comma-separated list of numeric IDs of centers to add the user to.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of centers for which the user should be opted in to email communications.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of groups to add the user to. Only available when called using an administrator account. Cannot be used for pre-defined groups (those with IDs less than 1000). Cannot be used for administrator security groups.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of email interests to add the user to. If the added interest is specific to a center, the constituent is also added to that center automatically.
Type xsd:string.
Optional. The constituent ID (Luminate Online ID) that uniquely identifies the constituent. This value is automatically assigned when a new constituent record is created. It can be used to uniquely identify a constituent record to read or update it. Only available when called using an administrator account.
Type xsd:string.
Optional. Text describing or associated with the interaction.
Type xsd:string.
Optional. The Security Category associated with this interaction. The default is 0, which corresponds to the "General" category.
Type xsd:nonNegativeInteger.
Default is 0.
Optional. The number of times the constituent performed this interaction.
Type xsd:nonNegativeInteger.
Default is 1.
Optional. Short, descriptive subject of the user interaction. Can be up to 80 characters in length.
Type xsd:string.
Optional. The member ID (Client ID) that uniquely identifies the constituent.
Type xsd:string.
Optional. The primary email address that uniquely identifies the constituent. Required to create a new constituent record. Optional when updating a record.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of centers to remove the user from.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of centers for which the user should be opted out of email communications.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of groups to remove the user from. Only valid when updating records. Only available when called using an administrator account. Cannot be used for pre-defined groups (those with IDs less than 1000). Cannot be used for administrator security groups.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of email interests to remove the user from. Only valid when updating records.
Type xsd:string.
Optional. Specifies whether data cleaning/standardization should be turned on or off. This parameter is intended for performance tuning for server side batch APIs calls.
Type xsd:boolean.
See topic Common Parameters.
Optional. Comma-separated list of numeric IDs of centers to add the user to.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of centers for which the user should be opted in to email communications.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of groups to add the user to. Only available when called using an administrator account. Cannot be used for pre-defined groups (those with IDs less than 1000). Cannot be used for administrator security groups.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of email interests to add the user to. If the added interest is specific to a center, the constituent is also added to that center automatically.
Type xsd:string.
Optional. The constituent ID (Luminate Online ID) that uniquely identifies the constituent. This value is automatically assigned when a new constituent record is created. It can be used to uniquely identify a constituent record to read or update it. Only available when called using an administrator account.
Type xsd:string.
Optional. Text describing or associated with the interaction.
Type xsd:string.
Optional. The Security Category associated with this interaction. The default is 0, which corresponds to the "General" category.
Type xsd:nonNegativeInteger.
Default is 0.
Optional. The number of times the constituent performed this interaction.
Type xsd:nonNegativeInteger.
Default is 1.
Optional. Short, descriptive subject of the user interaction. Can be up to 80 characters in length.
Type xsd:string.
Optional. The member ID (Client ID) that uniquely identifies the constituent.
Type xsd:string.
Optional. The primary email address that uniquely identifies the constituent. Required to create a new constituent record. Optional when updating a record.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of centers to remove the user from.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of centers for which the user should be opted out of email communications.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of groups to remove the user from. Only valid when updating records. Only available when called using an administrator account. Cannot be used for pre-defined groups (those with IDs less than 1000). Cannot be used for administrator security groups.
Type xsd:string.
Optional. Comma-separated list of numeric IDs of email interests to remove the user from. Only valid when updating records.
Type xsd:string.
Optional. Specifies whether data cleaning/standardization should be turned on or off. This parameter is intended for performance tuning for server side batch APIs calls.
Type xsd:boolean.
See topic HTTP Status Codes.
XML response<?xml version="1.0" encoding="UTF-8"?> <updateConsResponse xsi:schemaLocation="http://convio.com/crm/v1.0 http://service.convio.net/xmlschema/crm.public.v1.xsd" xmlns="http://convio.com/crm/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <cons_id>1001002</cons_id> <message>User updated.</message> </updateConsResponse>JSON response
{"updateConsResponse":{"message":"User updated.","cons_id":"1001002"}}