Entity attribute metadata messages

Applies to Dynamics 365 for Customer Engagement apps version 9.x

An entity attribute is a container for a piece of data in an entity. In this developer guide, the term “attribute” and “property” (class property) are often used interchangeably with the term “entity attribute.” The Dynamics 365 for Customer Engagement application uses the term “field” when it refers to entity attributes.


It is possible to create and update entity attributes using the Web API. See Create attributes using Web API for more details.

Entity attribute messages

The following table lists the messages that you can use to perform actions on entity attributes.

Message Web API Operation SDK Assembly
Create entity attributes
POST to EntityMetadata Attributes collection-valued navigation property with JSON definition of attribute. More information: Create attributes CreateAttributeRequest
Delete entity attributes
DELETE to the URL of the attribute. DeleteAttributeRequest
Delete an option from PicklistAttributeMetadata or StatusAttributeMetadata attributes
DeleteOptionValue Action DeleteOptionValueRequest
Add an option to a PicklistAttributeMetadata attribute
InsertOptionValue Action InsertOptionValueRequest
Add an option to a StatusAttributeMetadata attribute
InsertStatusValue Action InsertStatusValueRequest
Retrieve entity attributes
Use the Web API query mentioned in Querying EntityMetadata attributes to retrieve entity attributes. RetrieveAttributeRequest
Update entity attributes
See Update entities UpdateAttributeRequest
Update a label for a StateAttributeMetadata attribute
UpdateStateValue Action UpdateStateValueRequest

See also

Customize Entity Attribute Metadata
Create auto-number attribute
Work with Attributes
Sample: Work with Attributes