{"method":"POST","path":"https://api.revcent.com/v2/user_third_party_integrations","summary":"Create A User Third Party Integration","description":"Create a User Third Party Integration.<br><br>Important: After creating a user third party integration, you may need to edit the integration to provide any third_party_options that may be required. If a site third party integrations has third_party_options, you will need to retrieve the newly created integration using the GetUserThirdPartyIntegration operation to view options provided by the third party which are specific to a users' account with the third party. Review the site third party integration to see if there are any third_party_options, and if so, an edit is required via EditUserThirdPartyIntegration after the creation to include those options. If no site integration third_party_options are present there is no need to edit the user integration after creating it. View markdown documentation at https://revcent.com/documentation/markdown/mcp/operation/CreateUserThirdPartyIntegration.md for an in-depth overview of this operation.","operationId":"CreateUserThirdPartyIntegration","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"name":{"type":"string","description":"The User Third Party Integration name. Must be unique from other User Third Party Integration names."},"description":{"type":"string","description":"The User Third Party Integration description."},"enabled":{"type":"boolean","description":"Whether the User Third Party Integration is enabled."},"site_third_party_integration":{"type":"string","description":"A 20 character site third party integration ID. Every user third party integration must have a site third party integration associated. Use the GetSiteThirdPartyIntegrations operation to retrieve the list of available site third party integrations and their corresponding IDs.<br><br>Important: A site third party integration may require third_party_options, which will be listed in the third_party_options array when performing the GetSiteThirdPartyIntegration operation. If third_party_options are listed, you will need to perform the GetUserThirdPartyIntegration operation after creating the user third party integration to see what options are available specific to the users' account with the third party. After choosing the option values, then perform the EditUserThirdPartyIntegration operation to set the options necessary.","minLength":20,"maxLength":20},"third_party_credentials":{"type":"object","description":"The credentials required for the third party integration. The third_party_credentials object corresponds to the 'third_party_credentials' object when retrieving a site third party integration using the GetSiteThirdPartyIntegration operation. Credential id 'third_party_credentials.id' and fields 'third_party_credentials.fields' are required in accordance with the site third party integration. The credential fields and corresponding values will be encrypted and saved by RevCent.","additionalProperties":false,"properties":{"id":{"type":"string","description":"The third party credential ID, 'third_party_credentials.id', from the site third party integration."},"fields":{"type":"array","description":"An array of required fields and their values specific to the site third party integration 'third_party_credentials.fields'. Use the GetSiteThirdPartyIntegration operation with the third party integration ID to retrieve the list of 'third_party_credentials.fields' whose id's and corresponding value's you will need to provide.","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","description":"The ID of the field based on the id, i.e. 'credentials.fields[field].id', for the site third party integration."},"value":{"type":"string","description":"The value of the field, which will be encrypted and saved by RevCent."}},"required":["id","value"]}}},"required":["id","fields"]}},"required":["name","site_third_party_integration"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"API call response code.","type":"integer","format":"int32","enum":[1]},"user_third_party_integration_id":{"type":"string","description":"A 20 character user third party integration ID.","minLength":20,"maxLength":20},"result":{"type":"string"}},"type":"object","additionalProperties":false}}},"description":"Successful response."},"default":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"This value indicates that there is an error. Will always be 0.","type":"integer","enum":[0]},"error_code":{"description":"The specific error code.","type":"string"},"message":{"description":"A human readable description of the error.","type":"string"},"result":{"description":"A description of the API call result.","type":"string"}},"title":"APIStandardErrors","type":"object","additionalProperties":false}}},"description":"Error response."}}}