> ## Documentation Index > Fetch the complete documentation index at: https://docs.useparagon.com/llms.txt > Use this file to discover all available pages before exploring further. # Microsoft Dynamics Update Record Contact **Provider API:** Microsoft Dataverse Web API (v9.0). ## OpenAPI ````yaml actionkit/openapi.json POST /projects/{project_id}/tools/#MICROSOFT_DYNAMICS_UPDATE_RECORD_CONTACT openapi: 3.0.0 info: title: ActionKit Tools API version: 1.0.0 servers: - url: https://actionkit.useparagon.com description: US Cloud security: [] paths: /projects/{project_id}/tools/#MICROSOFT_DYNAMICS_UPDATE_RECORD_CONTACT: post: summary: Microsoft Dynamics Update Record Contact parameters: - name: project_id in: path required: true schema: type: string description: >- Your Paragon Project ID. You can copy your Project ID from your dashboard URL or by clicking Copy Project ID under the Environment switcher. requestBody: required: true content: application/json: schema: type: object properties: tool: type: string default: MICROSOFT_DYNAMICS_UPDATE_RECORD_CONTACT parameters: type: object properties: accountrolecode: type: number description: >- Select the contact's role within the company or sales process, such as decision maker, employee, or influencer. address1_addressid: type: string description: Unique identifier for address 1. address1_addresstypecode: type: number description: Select the primary address type. address1_city: type: string description: Type the city for the primary address. address1_country: type: string description: Type the country or region for the primary address. address1_county: type: string description: Type the county for the primary address. address1_fax: type: string description: Type the fax number associated with the primary address. address1_freighttermscode: type: number description: >- Select the freight terms for the primary address to make sure shipping orders are processed correctly. address1_latitude: type: number description: >- Type the latitude value for the primary address for use in mapping and other applications. address1_line1: type: string description: Type the first line of the primary address. address1_line2: type: string description: Type the second line of the primary address. address1_line3: type: string description: Type the third line of the primary address. address1_longitude: type: number description: >- Type the longitude value for the primary address for use in mapping and other applications. address1_name: type: string description: >- Type a descriptive name for the primary address, such as Corporate Headquarters. address1_postalcode: type: string description: >- Type the ZIP Code or postal code for the primary address. address1_postofficebox: type: string description: Type the post office box number of the primary address. address1_primarycontactname: type: string description: >- Type the name of the main contact at the account's primary address. address1_shippingmethodcode: type: number description: >- Select a shipping method for deliveries sent to this address. address1_stateorprovince: type: string description: Type the state or province of the primary address. address1_telephone1: type: string description: >- Type the main phone number associated with the primary address. address1_telephone2: type: string description: >- Type a second phone number associated with the primary address. address1_telephone3: type: string description: >- Type a third phone number associated with the primary address. address1_upszone: type: string description: >- Type the UPS zone of the primary address to make sure shipping charges are calculated correctly and deliveries are made promptly, if shipped by UPS. address1_utcoffset: type: number description: >- Select the time zone, or UTC offset, for this address so that other people can reference it when they contact someone at this address. address2_addressid: type: string description: Unique identifier for address 2. address2_addresstypecode: type: number description: Select the secondary address type. address2_city: type: string description: Type the city for the secondary address. address2_country: type: string description: Type the country or region for the secondary address. address2_county: type: string description: Type the county for the secondary address. address2_fax: type: string description: >- Type the fax number associated with the secondary address. address2_freighttermscode: type: number description: >- Select the freight terms for the secondary address to make sure shipping orders are processed correctly. address2_latitude: type: number description: >- Type the latitude value for the secondary address for use in mapping and other applications. address2_line1: type: string description: Type the first line of the secondary address. address2_line2: type: string description: Type the second line of the secondary address. address2_line3: type: string description: Type the third line of the secondary address. address2_longitude: type: number description: >- Type the longitude value for the secondary address for use in mapping and other applications. address2_name: type: string description: >- Type a descriptive name for the secondary address, such as Corporate Headquarters. address2_postalcode: type: string description: >- Type the ZIP Code or postal code for the secondary address. address2_postofficebox: type: string description: >- Type the post office box number of the secondary address. address2_primarycontactname: type: string description: >- Type the name of the main contact at the account's secondary address. address2_shippingmethodcode: type: number description: >- Select a shipping method for deliveries sent to this address. address2_stateorprovince: type: string description: Type the state or province of the secondary address. address2_telephone1: type: string description: >- Type the main phone number associated with the secondary address. address2_telephone2: type: string description: >- Type a second phone number associated with the secondary address. address2_telephone3: type: string description: >- Type a third phone number associated with the secondary address. address2_upszone: type: string description: >- Type the UPS zone of the secondary address to make sure shipping charges are calculated correctly and deliveries are made promptly, if shipped by UPS. address2_utcoffset: type: number description: >- Select the time zone, or UTC offset, for this address so that other people can reference it when they contact someone at this address. address3_addressid: type: string description: Unique identifier for address 3. address3_addresstypecode: type: number description: Select the third address type. address3_city: type: string description: Type the city for the 3rd address. address3_country: type: string description: the country or region for the 3rd address. address3_county: type: string description: Type the county for the third address. address3_fax: type: string description: Type the fax number associated with the third address. address3_freighttermscode: type: number description: >- Select the freight terms for the third address to make sure shipping orders are processed correctly. address3_latitude: type: number description: >- Type the latitude value for the third address for use in mapping and other applications. address3_line1: type: string description: the first line of the 3rd address. address3_line2: type: string description: the second line of the 3rd address. address3_line3: type: string description: the third line of the 3rd address. address3_longitude: type: number description: >- Type the longitude value for the third address for use in mapping and other applications. address3_name: type: string description: >- Type a descriptive name for the third address, such as Corporate Headquarters. address3_postalcode: type: string description: the ZIP Code or postal code for the 3rd address. address3_postofficebox: type: string description: the post office box number of the 3rd address. address3_primarycontactname: type: string description: >- Type the name of the main contact at the account's third address. address3_shippingmethodcode: type: number description: >- Select a shipping method for deliveries sent to this address. address3_stateorprovince: type: string description: the state or province of the third address. address3_telephone1: type: string description: >- Type the main phone number associated with the third address. address3_telephone2: type: string description: >- Type a second phone number associated with the third address. address3_telephone3: type: string description: >- Type a third phone number associated with the primary address. address3_upszone: type: string description: >- Type the UPS zone of the third address to make sure shipping charges are calculated correctly and deliveries are made promptly, if shipped by UPS. address3_utcoffset: type: number description: >- Select the time zone, or UTC offset, for this address so that other people can reference it when they contact someone at this address. adx_confirmremovepassword: type: boolean description: adx_ConfirmRemovePassword for contact adx_createdbyipaddress: type: string description: Adx_CreatedByIPAddress for contact adx_createdbyusername: type: string description: Adx_CreatedByUsername for contact adx_identity_accessfailedcount: type: number description: >- Shows the current count of failed password attempts for the contact. adx_identity_emailaddress1confirmed: type: boolean description: Determines if the email is confirmed by the contact. adx_identity_lastsuccessfullogin: type: string description: >- Indicates the last date and time the user successfully signed in to a portal. adx_identity_locallogindisabled: type: boolean description: >- Indicates that the contact can no longer sign in to the portal using the local account. adx_identity_lockoutenabled: type: boolean description: >- Determines if this contact will track failed access attempts and become locked after too many failed attempts. To prevent the contact from becoming locked, you can disable this setting. adx_identity_lockoutenddate: type: string description: >- Shows the moment in time when the locked contact becomes unlocked again. adx_identity_logonenabled: type: boolean description: >- Determines if web authentication is enabled for the contact. adx_identity_mobilephoneconfirmed: type: boolean description: >- Determines if the phone number is confirmed by the contact. adx_identity_newpassword: type: string description: adx_identity_newpassword for contact adx_identity_passwordhash: type: string description: adx_identity_passwordhash for contact adx_identity_securitystamp: type: string description: A token used to manage the web authentication session. adx_identity_twofactorenabled: type: boolean description: >- Determines if two-factor authentication is enabled for the contact. adx_identity_username: type: string description: Shows the user identity for local web authentication. adx_modifiedbyipaddress: type: string description: Adx_ModifiedByIPAddress for contact adx_modifiedbyusername: type: string description: Adx_ModifiedByUsername for contact adx_organizationname: type: string description: Adx_OrganizationName for contact adx_preferredlcid: type: number description: User’s preferred portal LCID adx_profilealert: type: boolean description: adx_profilealert for contact adx_profilealertdate: type: string description: adx_profilealertdate for contact adx_profilealertinstructions: type: string description: adx_profilealertinstructions for contact adx_profileisanonymous: type: boolean description: Adx_ProfileIsAnonymous for contact adx_profilelastactivity: type: string description: Adx_ProfileLastActivity for contact adx_profilemodifiedon: type: string description: adx_profilemodifiedon for contact adx_publicprofilecopy: type: string description: adx_PublicProfileCopy for contact adx_timezone: type: number description: Adx_TimeZone for contact anniversary: type: string description: >- Enter the date of the contact's wedding or service anniversary for use in customer gift programs or other communications. annualincome: type: number description: >- Type the contact's annual income for use in profiling and financial analysis. assistantname: type: string description: Type the name of the contact's assistant. assistantphone: type: string description: Type the phone number for the contact's assistant. birthdate: type: string description: >- Enter the contact's birthday for use in customer gift programs or other communications. business2: type: string description: Type a second business phone number for this contact. businesscard: type: string description: Stores Image of the Business Card businesscardattributes: type: string description: Stores Business Card Control Properties. callback: type: string description: Type a callback phone number for this contact. childrensnames: type: string description: >- Type the names of the contact's children for reference in communications and client programs. company: type: string description: Type the company phone of the contact. creditlimit: type: number description: >- Type the credit limit of the contact for reference when you address invoice and accounting issues with the customer. creditonhold: type: boolean description: >- Select whether the contact is on a credit hold, for reference when addressing invoice and accounting issues. customersizecode: type: number description: >- Select the size of the contact's company for segmentation and reporting purposes. customertypecode: type: number description: >- Select the category that best describes the relationship between the contact and your organization. defaultpricelevelid: type: object description: >- Choose the default price list associated with the contact to make sure the correct product prices for this customer are applied in sales opportunities, quotes, and orders. properties: {} department: type: string description: >- Type the department or business unit where the contact works in the parent company or business. description: type: string description: >- Type additional information to describe the contact, such as an excerpt from the company's website. donotbulkemail: type: boolean description: >- Select whether the contact accepts bulk email sent through marketing campaigns or quick campaigns. If Do Not Allow is selected, the contact can be added to marketing lists, but will be excluded from the email. donotbulkpostalmail: type: boolean description: >- Select whether the contact accepts bulk postal mail sent through marketing campaigns or quick campaigns. If Do Not Allow is selected, the contact can be added to marketing lists, but will be excluded from the letters. donotemail: type: boolean description: >- Select whether the contact allows direct email sent from Microsoft Dynamics 365. If Do Not Allow is selected, Microsoft Dynamics 365 will not send the email. donotfax: type: boolean description: >- Select whether the contact allows faxes. If Do Not Allow is selected, the contact will be excluded from any fax activities distributed in marketing campaigns. donotphone: type: boolean description: >- Select whether the contact accepts phone calls. If Do Not Allow is selected, the contact will be excluded from any phone call activities distributed in marketing campaigns. donotpostalmail: type: boolean description: >- Select whether the contact allows direct mail. If Do Not Allow is selected, the contact will be excluded from letter activities distributed in marketing campaigns. donotsendmm: type: boolean description: >- Select whether the contact accepts marketing materials, such as brochures or catalogs. Contacts that opt out can be excluded from marketing initiatives. educationcode: type: number description: >- Select the contact's highest level of education for use in segmentation and analysis. emailaddress1: type: string description: Type the primary email address for the contact. emailaddress2: type: string description: Type the secondary email address for the contact. emailaddress3: type: string description: Type an alternate email address for the contact. employeeid: type: string description: >- Type the employee ID or number for the contact for reference in orders, service cases, or other communications with the contact's organization. entityimage: type: object description: Shows the default image for the record. properties: {} externaluseridentifier: type: string description: Identifier for an external user. familystatuscode: type: number description: >- Select the marital status of the contact for reference in follow-up phone calls and other communications. fax: type: string description: Type the fax number for the contact. firstname: type: string description: >- Type the contact's first name to make sure the contact is addressed correctly in sales calls, email, and marketing campaigns. followemail: type: boolean description: >- Information about whether to allow following email activity like opens, attachment views and link clicks for emails sent to the contact. ftpsiteurl: type: string description: >- Type the URL for the contact's FTP site to enable users to access data and share documents. gendercode: type: number description: >- Select the contact's gender to make sure the contact is addressed correctly in sales calls, email, and marketing campaigns. governmentid: type: string description: >- Type the passport number or other government ID for the contact for use in documents or reports. haschildrencode: type: number description: >- Select whether the contact has any children for reference in follow-up phone calls and other communications. home2: type: string description: Type a second home phone number for this contact. isbackofficecustomer: type: boolean description: >- Select whether the contact exists in a separate accounting or other system, such as Microsoft Dynamics GP or another ERP database, for use in integration processes. jobtitle: type: string description: >- Type the job title of the contact to make sure the contact is addressed correctly in sales calls, email, and marketing campaigns. lastname: type: string description: >- Type the contact's last name to make sure the contact is addressed correctly in sales calls, email, and marketing campaigns. lastonholdtime: type: string description: >- Contains the date and time stamp of the last on hold time. lastusedincampaign: type: string description: >- Shows the date when the contact was last included in a marketing campaign or quick campaign. leadsourcecode: type: number description: >- Select the primary marketing source that directed the contact to your organization. managername: type: string description: >- Type the name of the contact's manager for use in escalating issues or other follow-up communications with the contact. managerphone: type: string description: Type the phone number for the contact's manager. marketingonly: type: boolean description: Whether is only for marketing middlename: type: string description: >- Type the contact's middle name or initial to make sure the contact is addressed correctly. mobilephone: type: string description: Type the mobile phone number for the contact. msa_managingpartnerid: type: object description: Unique identifier for Account associated with Contact. properties: {} msdyn_contactkpiid: type: object description: Maps to contact KPI records properties: {} msdyn_decisioninfluencetag: type: number description: Indicate buying influence using labels msdyn_disablewebtracking: type: boolean description: >- Indicates that the contact has opted out of web tracking. msdyn_gdproptout: type: boolean description: Describes whether contact is opted out or not msdyn_isassistantinorgchart: type: boolean description: Describes if the contact is an assistant in org chart msdyn_isminor: type: boolean description: >- Indicates that the contact is considered a minor in their jurisdiction. msdyn_isminorwithparentalconsent: type: boolean description: >- Indicates that the contact is considered a minor in their jurisdiction and has parental consent. msdyn_orgchangestatus: type: number description: >- Whether or not the contact belongs to the associated account msdyn_portaltermsagreementdate: type: string description: >- Indicates the date and time that the person agreed to the portal terms and conditions. msdyn_primarytimezone: type: number description: >- Indicates the primary time zone that the contact works on. msdyn_segmentid: type: object description: Unique identifier for Segment associated with contact. properties: {} mspp_userpreferredlcid: type: number description: User’s preferred portal language nickname: type: string description: Type the contact's nickname. numberofchildren: type: number description: >- Type the number of children the contact has for reference in follow-up phone calls and other communications. ownerid: type: object description: >- Enter the user or team who is assigned to manage the record. This field is updated every time the record is assigned to a different user. properties: {} owneridtype: type: object description: OwnerIdType for contact properties: {} pager: type: string description: Type the pager number for the contact. parentcustomerid: type: object description: >- Select the parent account or parent contact for the contact to provide a quick link to additional details, such as financial information, activities, and opportunities. properties: {} parentcustomeridtype: type: object description: ParentCustomerIdType for contact properties: {} participatesinworkflow: type: boolean description: >- Shows whether the contact participates in workflow rules. paymenttermscode: type: number description: >- Select the payment terms to indicate when the customer needs to pay the total amount. preferredappointmentdaycode: type: number description: >- Select the preferred day of the week for service appointments. preferredappointmenttimecode: type: number description: >- Select the preferred time of day for service appointments. preferredcontactmethodcode: type: number description: Select the preferred method of contact. preferredequipmentid: type: object description: >- Choose the contact's preferred service facility or equipment to make sure services are scheduled correctly for the customer. properties: {} preferredserviceid: type: object description: >- Choose the contact's preferred service to make sure services are scheduled correctly for the customer. properties: {} preferredsystemuserid: type: object description: >- Choose the regular or preferred customer service representative for reference when scheduling service activities for the contact. properties: {} processid: type: string description: Shows the ID of the process. salutation: type: string description: >- Type the salutation of the contact to make sure the contact is addressed correctly in sales calls, email messages, and marketing campaigns. shippingmethodcode: type: number description: >- Select a shipping method for deliveries sent to this address. slaid: type: object description: >- Choose the service level agreement (SLA) that you want to apply to the Contact record. properties: {} spousesname: type: string description: >- Type the name of the contact's spouse or partner for reference during calls, events, or other communications with the contact. stageid: type: string description: Shows the ID of the stage. statecode: type: number description: >- Shows whether the contact is active or inactive. Inactive contacts are read-only and can't be edited unless they are reactivated. statuscode: type: number description: Select the contact's status. suffix: type: string description: >- Type the suffix used in the contact's name, such as Jr. or Sr. to make sure the contact is addressed correctly in sales calls, email, and marketing campaigns. teamsfollowed: type: number description: Number of users or conversations followed the record telephone1: type: string description: Type the main phone number for this contact. telephone2: type: string description: Type a second phone number for this contact. telephone3: type: string description: Type a third phone number for this contact. territorycode: type: number description: >- Select a region or territory for the contact for use in segmentation and analysis. timezoneruleversionnumber: type: number description: For internal use only. transactioncurrencyid: type: object description: >- Choose the local currency for the record to make sure budgets are reported in the correct currency. properties: {} traversedpath: type: string description: For internal use only. utcconversiontimezonecode: type: number description: >- Time zone code that was in use when the record was created. websiteurl: type: string description: >- Type the contact's professional or personal website or blog URL. yomifirstname: type: string description: >- Type the phonetic spelling of the contact's first name, if the name is specified in Japanese, to make sure the name is pronounced correctly in phone calls with the contact. yomilastname: type: string description: >- Type the phonetic spelling of the contact's last name, if the name is specified in Japanese, to make sure the name is pronounced correctly in phone calls with the contact. yomimiddlename: type: string description: >- Type the phonetic spelling of the contact's middle name, if the name is specified in Japanese, to make sure the name is pronounced correctly in phone calls with the contact. entityId: type: string description: Entity ID to perform the operation on required: - lastname - entityId x-integration: microsoftDynamics required: - tool - parameters responses: '200': description: >- The Dataverse record after the update, as returned by Dataverse. The fields depend on the table and the connected environment. Fields with a null value are omitted from the example. content: application/json: examples: 'Success: Updated': summary: Contact updated value: '@odata.context': >- https://example.crm.dynamics.com/api/data/v9.0/$metadata#contacts/$entity '@odata.etag': W/"36693516" haschildrencode: 1 _ownerid_value: 746951b2-9038-43b3-ac28-16366bf692e3 fullname: Sample Docs Example merged: false customertypecode: 1 isbackofficecustomer: false adx_identity_emailaddress1confirmed: false yomifullname: Sample Docs Example participatesinworkflow: false followemail: true educationcode: 1 _owninguser_value: 746951b2-9038-43b3-ac28-16366bf692e3 emailaddress1: docs-example@example.com address2_shippingmethodcode: 1 adx_confirmremovepassword: false creditonhold: false address3_addressid: f927df2b-55aa-41ab-a865-b3d7b9646704 address1_addressid: 80a2c30a-7d30-47bf-aef2-b9f3e4c56f26 contactid: 148de854-b22d-4ee8-a3c4-e955e03709a1 donotphone: false _createdby_value: 746951b2-9038-43b3-ac28-16366bf692e3 donotemail: false donotsendmm: false firstname: Sample msdyn_isminorwithparentalconsent: false leadsourcecode: 1 _modifiedby_value: 746951b2-9038-43b3-ac28-16366bf692e3 marketingonly: false jobtitle: Engineer territorycode: 1 donotpostalmail: false adx_identity_twofactorenabled: false preferredappointmenttimecode: 1 _owningbusinessunit_value: a0b74d6c-90de-4c4f-a0e0-bf1888180f2d modifiedon: '2026-10-16T06:20:55Z' statuscode: 1 adx_identity_lockoutenabled: false shippingmethodcode: 1 donotbulkemail: false lastname: Docs Example adx_profileisanonymous: false versionnumber: 36693516 address2_freighttermscode: 1 msdyn_isminor: false statecode: 0 adx_profilealert: false customersizecode: 1 adx_identity_logonenabled: false adx_identity_mobilephoneconfirmed: false donotbulkpostalmail: false msdyn_disablewebtracking: false donotfax: false msdyn_gdproptout: false adx_identity_locallogindisabled: false address2_addresstypecode: 1 createdon: '2026-10-16T06:19:36Z' msdyn_orgchangestatus: 0 msdyn_isassistantinorgchart: false address2_addressid: 73819759-eb1c-49ee-aac3-441271508650 preferredcontactmethodcode: 1 security: - BearerAuth: [] components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Your [Paragon User Token](/getting-started/installing-the-connect-sdk#setup) (JWT), which you can generate using your project's signing keys. ````