# Add an Identity to the LINK stack Adds a new identity to the LINK database. Returns the resulting LINK identity, linkId, domains, and optional events generated by the operation. Endpoint: POST /postIdentity Version: 2026.1.2 Security: bearerAuth ## Request fields (application/json): - `auditId` (string) Audit identifier used for tracing and governance across Verato services. - `auditLogMap` (object) Generic map of string keys to string values. - `content` (object) Adds a new identity to the LINK database. - `content.identity` (object, required) Logical identity in the Verato platform. Contains domain-specific attributes for Person, Provider, Health Facility, and Organization. - `content.identity.organizationNames` (array) - `content.identity.organizationNames.legalBusinessName` (string) TEXT data type, see documentation for more details. - `content.identity.organizationNames.otherOrgName` (string) TEXT data type, see documentation for more details. - `content.identity.organizationNames.tradingName` (string) TEXT data type, see documentation for more details. - `content.identity.organizationNames.parentOrgName` (string) TEXT data type, see documentation for more details. - `content.identity.addresses` (array) - `content.identity.addresses.addressName` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.addressType` (string) CODE-SET data type, see documentation for more details. - `content.identity.addresses.line1` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.line2` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.city` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.district` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.state` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.postalCode` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.country` (string) TEXT data type, see documentation for more details. - `content.identity.addresses.latitude` (string) NUMBER data type, see documentation for more details. - `content.identity.addresses.longitude` (string) NUMBER data type, see documentation for more details. - `content.identity.addresses.validFrom` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.addresses.validTo` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.contactInformation` (array) Example: [{"address":{"line1":"123 Main St","city":"Springfield","state":"VA","postalCode":"22150"},"phoneList":[{"number":"5551234567","type":"WORK","bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}],"bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}] - `content.identity.contactInformation.address` (object) - `content.identity.contactInformation.phoneList` (array) Example: [{"number":"5551234567","type":"WORK","bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}] - `content.identity.contactInformation.phoneList.number` (string) NUMBER data type, see documentation for more details. - `content.identity.contactInformation.phoneList.type` (string) CODE-SET data type, see documentation for more details. - `content.identity.contactInformation.phoneList.bestTimeToContact` (object) - `content.identity.contactInformation.phoneList.bestTimeToContact.day` (string) CODE-SET data type, see documentation for more details. - `content.identity.contactInformation.phoneList.bestTimeToContact.startTime` (string) TIME data type, see documentation for more details. - `content.identity.contactInformation.phoneList.bestTimeToContact.endTime` (string) TIME data type, see documentation for more details. - `content.identity.contactInformation.phoneList.bestTimeToContact.allDay` (boolean) BOOLEAN data type, see documentation for more details. - `content.identity.contactInformation.faxList` (array) - `content.identity.contactInformation.faxList.number` (string) TEXT data type, see documentation for more details. - `content.identity.phoneNumbers` (array) Example: [{"number":"5551234567","type":"WORK","validFrom":"2024-01-01","validTo":"2024-12-31","bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}] - `content.identity.faxNumbers` (array) - `content.identity.emails` (array) - `content.identity.emails.email` (string) TEXT data type, see documentation for more details. - `content.identity.alternateIdentifiers` (array) - `content.identity.alternateIdentifiers.description` (string) TEXT data type, see documentation for more details. - `content.identity.alternateIdentifiers.value` (string) TEXT data type, see documentation for more details. - `content.identity.alternateIdentifiers.status` (boolean) BOOLEAN data type, see documentation for more details. - `content.identity.alternateIdentifiers.issuer` (string) TEXT data type, see documentation for more details. - `content.identity.alternateIdentifiers.issueDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.alternateIdentifiers.startDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.alternateIdentifiers.endDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.externalUniqueIdentifier` (array) - `content.identity.externalUniqueIdentifier.status` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials` (array) - `content.identity.authorizedOfficials.title` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.prefix` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.first` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.middle` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.last` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.suffix` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.credential` (string) TEXT data type, see documentation for more details. - `content.identity.authorizedOfficials.phoneNumber` (string) TEXT data type, see documentation for more details. - `content.identity.employerIdentificationNumber` (array) - `content.identity.naicsClassifications` (array) - `content.identity.naicsClassifications.sector` (string) CODE-SET data type, see documentation for more details. - `content.identity.naicsClassifications.subSector` (string) CODE-SET data type, see documentation for more details. - `content.identity.naicsClassifications.industryGroup` (string) CODE-SET data type, see documentation for more details. - `content.identity.naicsClassifications.industry` (string) CODE-SET data type, see documentation for more details. - `content.identity.naicsClassifications.nationalIndustry` (string) CODE-SET data type, see documentation for more details. - `content.identity.sicClassifications` (array) - `content.identity.sicClassifications.code` (string) CODE-SET data type, see documentation for more details. - `content.identity.qualifications` (array) - `content.identity.qualifications.qualification` (string) TEXT data type, see documentation for more details. - `content.identity.qualifications.status` (string) CODE-SET data type, see documentation for more details. - `content.identity.types` (array) - `content.identity.types.type` (string) TEXT data type, see documentation for more details. - `content.identity.types.subType` (string) TEXT data type, see documentation for more details. - `content.identity.contactOther` (array) - `content.identity.contactOther.system` (string) CODE-SET data type, see documentation for more details. - `content.identity.product` (array) - `content.identity.product.name` (string) TEXT data type, see documentation for more details. - `content.identity.product.code` (string) TEXT data type, see documentation for more details. - `content.identity.product.category` (string) TEXT data type, see documentation for more details. - `content.identity.product.price` (string) NUMBER data type, see documentation for more details. - `content.identity.product.launchDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.product.market` (string) TEXT data type, see documentation for more details. - `content.identity.product.lineOfBusiness` (string) TEXT data type, see documentation for more details. - `content.identity.product.serviceLines` (array) - `content.identity.product.serviceLines.serviceLine` (string) TEXT data type, see documentation for more details. - `content.identity.product.serviceLines.subServiceLine` (string) TEXT data type, see documentation for more details. - `content.identity.numberOfEmployees` (array) - `content.identity.numberOfEmployees.numberOfEmployees` (string) NUMBER data type, see documentation for more details. - `content.identity.foundedDate` (array) - `content.identity.foundedDate.foundedDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.annualRevenue` (array) - `content.identity.annualRevenue.annualRevenue` (string) NUMBER data type, see documentation for more details. - `content.identity.annualRevenue.year` (string) NUMBER data type, see documentation for more details. - `content.identity.legalStatus` (array) - `content.identity.legalStatus.source` (string) TEXT data type, see documentation for more details. - `content.identity.legalStatus.effectiveDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.legalStatus.verificationDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.identity.legalStatus.jurisdiction` (string) TEXT data type, see documentation for more details. - `content.identity.legalStatus.registrationCountry` (string) CODE-SET data type, see documentation for more details. - `content.responseIdentityFormatNames` (array) Names of response identity formats to include. If omitted, DEFAULT is assumed. - `trackingId` (string) ## Response 200 fields (application/json): - `auditId` (string) Audit identifier used for tracing and governance across Verato services. - `success` (boolean) - `unparsedJson` (string) - `warnings` (array) - `retryableError` (boolean) - `message` (string) - `content` (object) PostIdentity service response. - `content.identityGroupedBySource` (array) Alternative view where info is grouped by source. - `content.identityGroupedBySource.source` (object) Tracks an identity to a particular source system and record ID. - `content.identityGroupedBySource.source.date` (string) The date of the source data in ISO format (yyyy-MM-dd). - `content.identityGroupedBySource.source.name` (string) Name of the data source. Must be unique across Verato. - `content.identityGroupedBySource.source.id` (string) ID of an identity within the given data source. - `content.customerSources` (array) - `content.linkIdentity` (object) Logical identity in the Verato platform. Contains domain-specific attributes for Person, Provider, Health Facility, and Organization. - `content.linkIdentity.organizationNames` (array) - `content.linkIdentity.organizationNames.legalBusinessName` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.organizationNames.otherOrgName` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.organizationNames.tradingName` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.organizationNames.parentOrgName` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.addresses` (array) - `content.linkIdentity.addresses.addressName` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.addresses.addressType` (string) CODE-SET data type, see documentation for more details. - `content.linkIdentity.addresses.line1` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.addresses.line2` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.addresses.city` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.addresses.district` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.addresses.state` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.addresses.postalCode` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.addresses.country` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.addresses.latitude` (string) NUMBER data type, see documentation for more details. - `content.linkIdentity.addresses.longitude` (string) NUMBER data type, see documentation for more details. - `content.linkIdentity.addresses.validFrom` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.linkIdentity.addresses.validTo` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.linkIdentity.contactInformation` (array) Example: [{"address":{"line1":"123 Main St","city":"Springfield","state":"VA","postalCode":"22150"},"phoneList":[{"number":"5551234567","type":"WORK","bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}],"bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}] - `content.linkIdentity.contactInformation.address` (object) - `content.linkIdentity.contactInformation.phoneList` (array) Example: [{"number":"5551234567","type":"WORK","bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}] - `content.linkIdentity.contactInformation.phoneList.number` (string) NUMBER data type, see documentation for more details. - `content.linkIdentity.contactInformation.phoneList.type` (string) CODE-SET data type, see documentation for more details. - `content.linkIdentity.contactInformation.phoneList.bestTimeToContact` (object) - `content.linkIdentity.contactInformation.phoneList.bestTimeToContact.day` (string) CODE-SET data type, see documentation for more details. - `content.linkIdentity.contactInformation.phoneList.bestTimeToContact.startTime` (string) TIME data type, see documentation for more details. - `content.linkIdentity.contactInformation.phoneList.bestTimeToContact.endTime` (string) TIME data type, see documentation for more details. - `content.linkIdentity.contactInformation.phoneList.bestTimeToContact.allDay` (boolean) BOOLEAN data type, see documentation for more details. - `content.linkIdentity.contactInformation.faxList` (array) - `content.linkIdentity.contactInformation.faxList.number` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.phoneNumbers` (array) Example: [{"number":"5551234567","type":"WORK","validFrom":"2024-01-01","validTo":"2024-12-31","bestTimeToContact":{"day":"MON","startTime":"09:00","endTime":"17:00","allDay":false}}] - `content.linkIdentity.faxNumbers` (array) - `content.linkIdentity.emails` (array) - `content.linkIdentity.emails.email` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.alternateIdentifiers` (array) - `content.linkIdentity.alternateIdentifiers.description` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.alternateIdentifiers.value` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.alternateIdentifiers.status` (boolean) BOOLEAN data type, see documentation for more details. - `content.linkIdentity.alternateIdentifiers.issuer` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.alternateIdentifiers.issueDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.linkIdentity.alternateIdentifiers.startDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.linkIdentity.alternateIdentifiers.endDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.linkIdentity.externalUniqueIdentifier` (array) - `content.linkIdentity.externalUniqueIdentifier.status` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.authorizedOfficials` (array) - `content.linkIdentity.authorizedOfficials.title` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.authorizedOfficials.prefix` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.authorizedOfficials.first` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.authorizedOfficials.middle` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.authorizedOfficials.last` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.authorizedOfficials.suffix` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.authorizedOfficials.credential` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.authorizedOfficials.phoneNumber` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.employerIdentificationNumber` (array) - `content.linkIdentity.naicsClassifications` (array) - `content.linkIdentity.naicsClassifications.sector` (string) CODE-SET data type, see documentation for more details. - `content.linkIdentity.naicsClassifications.subSector` (string) CODE-SET data type, see documentation for more details. - `content.linkIdentity.naicsClassifications.industryGroup` (string) CODE-SET data type, see documentation for more details. - `content.linkIdentity.naicsClassifications.industry` (string) CODE-SET data type, see documentation for more details. - `content.linkIdentity.naicsClassifications.nationalIndustry` (string) CODE-SET data type, see documentation for more details. - `content.linkIdentity.sicClassifications` (array) - `content.linkIdentity.sicClassifications.code` (string) CODE-SET data type, see documentation for more details. - `content.linkIdentity.qualifications` (array) - `content.linkIdentity.qualifications.qualification` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.qualifications.status` (string) CODE-SET data type, see documentation for more details. - `content.linkIdentity.types` (array) - `content.linkIdentity.types.type` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.types.subType` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.contactOther` (array) - `content.linkIdentity.contactOther.system` (string) CODE-SET data type, see documentation for more details. - `content.linkIdentity.product` (array) - `content.linkIdentity.product.name` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.product.code` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.product.category` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.product.price` (string) NUMBER data type, see documentation for more details. - `content.linkIdentity.product.launchDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.linkIdentity.product.market` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.product.lineOfBusiness` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.product.serviceLines` (array) - `content.linkIdentity.product.serviceLines.serviceLine` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.product.serviceLines.subServiceLine` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.numberOfEmployees` (array) - `content.linkIdentity.numberOfEmployees.numberOfEmployees` (string) NUMBER data type, see documentation for more details. - `content.linkIdentity.foundedDate` (array) - `content.linkIdentity.foundedDate.foundedDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.linkIdentity.annualRevenue` (array) - `content.linkIdentity.annualRevenue.annualRevenue` (string) NUMBER data type, see documentation for more details. - `content.linkIdentity.annualRevenue.year` (string) NUMBER data type, see documentation for more details. - `content.linkIdentity.legalStatus` (array) - `content.linkIdentity.legalStatus.source` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.legalStatus.effectiveDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.linkIdentity.legalStatus.verificationDate` (string) DATE data type (yyyy-MM-dd), see documentation for more details. - `content.linkIdentity.legalStatus.jurisdiction` (string) TEXT data type, see documentation for more details. - `content.linkIdentity.legalStatus.registrationCountry` (string) CODE-SET data type, see documentation for more details. - `content.linkId` (string) LINK ID of the returned identity, if any; null if no match. - `content.identity` (object) Logical identity in the Verato platform. Contains domain-specific attributes for Person, Provider, Health Facility, and Organization. - `content.domains` (array) Domains of the returned identity, if any. - `content.domains.name` (string) - `content.domains.id` (string) - `content.customizedIdentities` (object) Alternative views customized by view name, keyed by view name. - `content.events` (array) - `content.incomingIdentity` (object) Logical identity in the Verato platform. Contains domain-specific attributes for Person, Provider, Health Facility, and Organization. - `errors` (array) - `trackingId` (string)