LinkedIn conversionHappenedAt is milliseconds
The inverse of Meta. LinkedIn documents milliseconds and rejects events older than 90 days. A 10-digit Unix timestamp is seconds, and as milliseconds it is 1970, which is older than 90 days.
Date.now() is already the right unit. conversion is urn:lla:llaPartnerConversion:ID. user.userIds is required even when you identify on lead, externalIds, or userInfo: send an empty list in those cases.
conversionHappenedAt is 13 digits
Milliseconds since epoch. Do not floor Date.now() / 1000 because the Meta CAPI snippet did.
Rule: vendor.linkedin-conversions-api.body.conversionHappenedAt.invalid
What this pack matches
Rules
Codes are stable. A finding in CI, MCP, or the playground lands on the same id.
| Field | Required | What it checks | Rule ids | Source |
|---|---|---|---|---|
elements |
optional | The vendor documents the JSON shape or value type of this field. Native JSON type: array. Minimum array items: 1. Maximum array items: 5000. | vendor.linkedin-conversions-api.body.elements.invalid |
docs |
elements[] |
optional | The vendor documents the JSON shape or value type of this field. Native JSON type: object. | vendor.linkedin-conversions-api.body.elements[].invalid |
docs |
conversion |
required | It is the conversion rule URN the event is attributed to, in the form `urn:lla:llaPartnerConversion:ID`. Body scope: ["elements[]",""]. Fix: Send the URN of a conversion rule created with `conversionMethod` set to `CONVERSIONS_API`. | vendor.linkedin-conversions-api.body.conversion.missingvendor.linkedin-conversions-api.body.conversion.emptyvendor.linkedin-conversions-api.body.conversion.invalid |
docs |
conversionHappenedAt |
required | LinkedIn documents it as an epoch timestamp in milliseconds, and rejects events older than 90 days. A 10-digit value is seconds and lands in 1970. Body scope: ["elements[]",""]. Native JSON type: integer. Fix: Send milliseconds, not seconds: a JavaScript `Date.now()` is already in the right unit. | vendor.linkedin-conversions-api.body.conversionHappenedAt.missingvendor.linkedin-conversions-api.body.conversionHappenedAt.emptyvendor.linkedin-conversions-api.body.conversionHappenedAt.invalid |
docs |
user.userIds |
required | LinkedIn returns a 422 when `user.userIds` is absent. Identifying the person by `lead`, `externalIds`, or `userInfo` instead still requires it, sent as an empty list. Body scope: ["elements[]",""]. Presence diagnostic severity: error. Native JSON type: array. Fix: Add `user.userIds`. If you match on something else, send it as an empty list: `"userIds": []`. | vendor.linkedin-conversions-api.body.user.userIds.missingvendor.linkedin-conversions-api.body.user.userIds.invalid |
docs |
user.userIds[].idType |
required | It names the kind of identifier carried in `idValue`. LinkedIn documents `SHA256_EMAIL`, `LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID`, `ACXIOM_ID`, `PLAINTEXT_IP_ADDRESS`, `SHA256_IP_ADDRESS`, and `GOOGLE_AID`. Body scope: ["elements[]",""]. Value diagnostic severity: warning. Native JSON type: string. Fix: Use one of the documented identifier types. | vendor.linkedin-conversions-api.body.user.userIds[].idType.missingvendor.linkedin-conversions-api.body.user.userIds[].idType.emptyvendor.linkedin-conversions-api.body.user.userIds[].idType.invalid |
docs |
user.userIds[].idValue |
required | LinkedIn rejects the event when an identifier is present but empty. Body scope: ["elements[]",""]. Native JSON type: string. Fix: Populate `idValue`, or drop the entry entirely rather than sending it blank. | vendor.linkedin-conversions-api.body.user.userIds[].idValue.missingvendor.linkedin-conversions-api.body.user.userIds[].idValue.emptyvendor.linkedin-conversions-api.body.user.userIds[].idValue.invalid |
docs |
user.lead |
optional | LinkedIn rejects a `lead` that is not a valid URN. Body scope: ["elements[]",""]. Fix: Send it as `urn:li:leadGenFormResponse:ID`. | vendor.linkedin-conversions-api.body.user.lead.emptyvendor.linkedin-conversions-api.body.user.lead.invalid |
docs |
user.externalIds[] |
optional | It is an advertiser-provided identifier for the converting user. LinkedIn documents at most one value in the list, and requires a standard identifier alongside the first send. Body scope: ["elements[]",""]. Native JSON type: string. Fix: Send `user.externalIds` as a one-item list, together with `userIds` or `userInfo` on the first match. | vendor.linkedin-conversions-api.body.user.externalIds[].emptyvendor.linkedin-conversions-api.body.user.externalIds[].invalid |
docs |
user.userInfo.firstName |
optional | It is the contact first name in plain text. LinkedIn documents it with `lastName` for probabilistic matching. Body scope: ["elements[]",""]. Native JSON type: string. Fix: Send `user.userInfo.firstName` with `lastName`, or send the hashed pair instead. | vendor.linkedin-conversions-api.body.user.userInfo.firstName.emptyvendor.linkedin-conversions-api.body.user.userInfo.firstName.invalid |
docs |
user.userInfo.lastName |
optional | It is the contact last name in plain text. LinkedIn documents it with `firstName` for probabilistic matching. Body scope: ["elements[]",""]. Native JSON type: string. Fix: Send `user.userInfo.lastName` with `firstName`, or send the hashed pair instead. | vendor.linkedin-conversions-api.body.user.userInfo.lastName.emptyvendor.linkedin-conversions-api.body.user.userInfo.lastName.invalid |
docs |
user.userInfo.hashedFirstName |
optional | It is the SHA-256 hex digest of the first name. LinkedIn documents lowercase, no spaces or punctuation, UTF-8, then SHA-256. Body scope: ["elements[]",""]. Native JSON type: string. Fix: Send a 64-character lowercase hex digest in `user.userInfo.hashedFirstName` with `hashedLastName`. | vendor.linkedin-conversions-api.body.user.userInfo.hashedFirstName.emptyvendor.linkedin-conversions-api.body.user.userInfo.hashedFirstName.invalid |
docs |
user.userInfo.hashedLastName |
optional | It is the SHA-256 hex digest of the last name. LinkedIn documents lowercase, no spaces or punctuation, UTF-8, then SHA-256. Body scope: ["elements[]",""]. Native JSON type: string. Fix: Send a 64-character lowercase hex digest in `user.userInfo.hashedLastName` with `hashedFirstName`. | vendor.linkedin-conversions-api.body.user.userInfo.hashedLastName.emptyvendor.linkedin-conversions-api.body.user.userInfo.hashedLastName.invalid |
docs |
user.userInfo.companyName |
optional | It is the company name in plain text. LinkedIn documents it as an optional userInfo match field. Body scope: ["elements[]",""]. Native JSON type: string. Fix: Send `user.userInfo.companyName`, or drop the empty pair. | vendor.linkedin-conversions-api.body.user.userInfo.companyName.emptyvendor.linkedin-conversions-api.body.user.userInfo.companyName.invalid |
docs |
user.userInfo.title |
optional | It is the job title in plain text. LinkedIn documents it as an optional userInfo match field. Body scope: ["elements[]",""]. Native JSON type: string. Fix: Send `user.userInfo.title`, or drop the empty pair. | vendor.linkedin-conversions-api.body.user.userInfo.title.emptyvendor.linkedin-conversions-api.body.user.userInfo.title.invalid |
docs |
user.userInfo.countryCode |
optional | It is an ISO two-letter country or region code. LinkedIn documents `US` as the example. Body scope: ["elements[]",""]. Fix: Send a two-letter code such as `US`. | vendor.linkedin-conversions-api.body.user.userInfo.countryCode.emptyvendor.linkedin-conversions-api.body.user.userInfo.countryCode.invalid |
docs |
conversionValue.currencyCode |
optional | It is the three-letter currency code of the conversion value. Body scope: ["elements[]",""]. Fix: Use the ISO 4217 code, such as `USD`. | vendor.linkedin-conversions-api.body.conversionValue.currencyCode.emptyvendor.linkedin-conversions-api.body.conversionValue.currencyCode.invalid |
docs |
conversionValue.amount |
optional | LinkedIn documents the amount as a decimal string, as in `"50.0"`. Body scope: ["elements[]",""]. Native JSON type: string. Fix: Send the amount as a string holding a decimal number, without a currency symbol. | vendor.linkedin-conversions-api.body.conversionValue.amount.emptyvendor.linkedin-conversions-api.body.conversionValue.amount.invalid |
docs |
eventId |
optional | It identifies the event so repeated sends are not counted twice. Body scope: ["elements[]",""]. Native JSON type: string. | vendor.linkedin-conversions-api.body.eventId.emptyvendor.linkedin-conversions-api.body.eventId.invalid |
docs |
root |
optional | Each event is a JSON object, rather than a scalar or list. Body scope: ["elements[]",""]. Native JSON type: object. | vendor.linkedin-conversions-api.body.root.invalid |
docs |
user |
optional | The vendor documents the JSON shape or value type of this field. Body scope: ["elements[]",""]. Native JSON type: object. | vendor.linkedin-conversions-api.body.user.invalid |
docs |
user.userInfo |
optional | The vendor documents the JSON shape or value type of this field. Body scope: ["elements[]",""]. Native JSON type: object. | vendor.linkedin-conversions-api.body.user.userInfo.invalid |
docs |
conversionValue |
optional | The vendor documents the JSON shape or value type of this field. Body scope: ["elements[]",""]. Native JSON type: object. | vendor.linkedin-conversions-api.body.conversionValue.invalid |
docs |
user.userIds[] |
optional | The vendor documents the JSON shape or value type of this field. Body scope: ["elements[]",""]. Native JSON type: object. | vendor.linkedin-conversions-api.body.user.userIds[].invalid |
docs |
user.externalIds |
optional | The vendor documents the JSON shape or value type of this field. Body scope: ["elements[]",""]. Native JSON type: array. | vendor.linkedin-conversions-api.body.user.externalIds.invalid |
docs |
body.value_needs_both_fields |
required | `conversionValue` carries an amount with no `currencyCode`. LinkedIn documents both fields together. Body scope: ["elements[]",""]. Fix: Add `conversionValue.currencyCode` alongside the amount. | vendor.linkedin-conversions-api.body.value_needs_both_fields |
docs |
body.unhashed_email |
required | An identifier carries what looks like a raw email address. LinkedIn matches on `SHA256_EMAIL`, which is the SHA-256 digest rather than the address. Body scope: ["elements[]",""]. Fix: Lowercase and trim the address, hash it with SHA-256, and send the hex digest with `idType` set to `SHA256_EMAIL`. | vendor.linkedin-conversions-api.body.unhashed_email |
docs |
firstName |
optional | The current official vendor reference documents this field. Body scope: ["elements[].user.userInfo","user.userInfo"]. | docs | |
lastName |
optional | The current official vendor reference documents this field. Body scope: ["elements[].user.userInfo","user.userInfo"]. | docs | |
hashedFirstName |
optional | The current official vendor reference documents this field. Body scope: ["elements[].user.userInfo","user.userInfo"]. | docs | |
hashedLastName |
optional | The current official vendor reference documents this field. Body scope: ["elements[].user.userInfo","user.userInfo"]. | docs | |
body.userinfo_requires_first_and_last |
required | User information requires a first-name and last-name combination. Each name may be plaintext or hashed. Body scope: ["elements[].user.userInfo","user.userInfo"]. | vendor.linkedin-conversions-api.body.userinfo_requires_first_and_last |
docs |
idType |
optional | The current official vendor reference documents this field. Body scope: ["elements[].user.userIds[]","user.userIds[]"]. | docs | |
idValue |
optional | The current official vendor reference documents this field. Body scope: ["elements[].user.userIds[]","user.userIds[]"]. | docs | |
body.sha256_identifiers_require_hash |
required | A SHA256 identifier must be a SHA256 hexadecimal digest. Body scope: ["elements[].user.userIds[]","user.userIds[]"]. | vendor.linkedin-conversions-api.body.sha256_identifiers_require_hash |
docs |
body.plaintext_ip_requires_ipv4 |
required | The PLAINTEXT_IP_ADDRESS identifier supports IPv4 only. Body scope: ["elements[].user.userIds[]","user.userIds[]"]. | vendor.linkedin-conversions-api.body.plaintext_ip_requires_ipv4 |
docs |
body.google_aid_requires_uuid |
required | The Google advertising ID is a UUID. Body scope: ["elements[].user.userIds[]","user.userIds[]"]. | vendor.linkedin-conversions-api.body.google_aid_requires_uuid |
docs |
method |
required | This endpoint documents POST requests. Complete HTTP capture contract. Native JSON type: string. | vendor.linkedin-conversions-api.http.method.missingvendor.linkedin-conversions-api.http.method.emptyvendor.linkedin-conversions-api.http.method.invalid |
docs |
path |
required | Use the documented event endpoint route. Complete HTTP capture contract. Native JSON type: string. | vendor.linkedin-conversions-api.http.path.missingvendor.linkedin-conversions-api.http.path.emptyvendor.linkedin-conversions-api.http.path.invalid |
docs |
content_type |
required | The request carries an application/json body. Complete HTTP capture contract. Native JSON type: string. | vendor.linkedin-conversions-api.http.content_type.missingvendor.linkedin-conversions-api.http.content_type.emptyvendor.linkedin-conversions-api.http.content_type.invalid |
docs |
body_encoding |
required | The event request is encoded as JSON. Complete HTTP capture contract. Native JSON type: string. | vendor.linkedin-conversions-api.http.body_encoding.missingvendor.linkedin-conversions-api.http.body_encoding.emptyvendor.linkedin-conversions-api.http.body_encoding.invalid |
docs |
headers.authorization |
required | Authenticate with a populated Bearer token. Complete HTTP capture contract. Native JSON type: string. | vendor.linkedin-conversions-api.http.headers.authorization.missingvendor.linkedin-conversions-api.http.headers.authorization.emptyvendor.linkedin-conversions-api.http.headers.authorization.invalid |
docs |
headers.linkedin-version |
required | LinkedIn requires its YYYYMM API version header. Complete HTTP capture contract. Native JSON type: string. | vendor.linkedin-conversions-api.http.headers.linkedin-version.missingvendor.linkedin-conversions-api.http.headers.linkedin-version.emptyvendor.linkedin-conversions-api.http.headers.linkedin-version.invalid |
docs |
headers.x-restli-protocol-version |
required | The required Rest.li protocol version is 2.0.0. Complete HTTP capture contract. Native JSON type: string. | vendor.linkedin-conversions-api.http.headers.x-restli-protocol-version.missingvendor.linkedin-conversions-api.http.headers.x-restli-protocol-version.emptyvendor.linkedin-conversions-api.http.headers.x-restli-protocol-version.invalid |
docs |
body.elements |
optional | The elements array selects the documented batch-create transport. Complete HTTP capture contract. | docs | |
headers.x-restli-method |
optional | Batch conversion creation requires BATCH_CREATE. Complete HTTP capture contract. Native JSON type: string. | vendor.linkedin-conversions-api.http.headers.x-restli-method.invalid |
docs |
url |
required | The published request endpoint uses HTTPS. Complete HTTP capture contract. Native JSON type: string. | vendor.linkedin-conversions-api.http.url.missingvendor.linkedin-conversions-api.http.url.emptyvendor.linkedin-conversions-api.http.url.invalid |
docs |
http.batch_create_header_required |
required | Batch conversionEvents requests require X-RestLi-Method. Complete HTTP capture contract. | vendor.linkedin-conversions-api.http.batch_create_header_required |
docs |
http.batch_create_header_value |
required | The batch operation header must be BATCH_CREATE. Complete HTTP capture contract. | vendor.linkedin-conversions-api.http.batch_create_header_value |
docs |
api_version |
optional | Version is read from the actual request header. Complete HTTP capture contract. Capture scope: ["body.elements[].user.userInfo","body.user.userInfo"]. | docs | |
firstName |
required | Before API version 202609, userInfo requires the plain first and last names. Complete HTTP capture contract. Capture scope: ["body.elements[].user.userInfo","body.user.userInfo"]. Applies when {"kind":"value_pattern","param":"api_version","pattern":"^(?:[01][0-9]{5}|20[01][0-9]{3}|202[0-5][0-9]{2}|20260[1-8])$"}. Native JSON type: string. | vendor.linkedin-conversions-api.http.firstName.missingvendor.linkedin-conversions-api.http.firstName.emptyvendor.linkedin-conversions-api.http.firstName.invalid |
docs |
lastName |
required | Before API version 202609, userInfo requires the plain first and last names. Complete HTTP capture contract. Capture scope: ["body.elements[].user.userInfo","body.user.userInfo"]. Applies when {"kind":"value_pattern","param":"api_version","pattern":"^(?:[01][0-9]{5}|20[01][0-9]{3}|202[0-5][0-9]{2}|20260[1-8])$"}. Native JSON type: string. | vendor.linkedin-conversions-api.http.lastName.missingvendor.linkedin-conversions-api.http.lastName.emptyvendor.linkedin-conversions-api.http.lastName.invalid |
docs |
hashedFirstName |
forbidden | Hashed name fields became available in API version 202609. Complete HTTP capture contract. Capture scope: ["body.elements[].user.userInfo","body.user.userInfo"]. Applies when {"kind":"value_pattern","param":"api_version","pattern":"^(?:[01][0-9]{5}|20[01][0-9]{3}|202[0-5][0-9]{2}|20260[1-8])$"}. | vendor.linkedin-conversions-api.http.hashedFirstName.forbidden |
docs |
hashedLastName |
forbidden | Hashed name fields became available in API version 202609. Complete HTTP capture contract. Capture scope: ["body.elements[].user.userInfo","body.user.userInfo"]. Applies when {"kind":"value_pattern","param":"api_version","pattern":"^(?:[01][0-9]{5}|20[01][0-9]{3}|202[0-5][0-9]{2}|20260[1-8])$"}. | vendor.linkedin-conversions-api.http.hashedLastName.forbidden |
docs |
Validate a payload
pixellint validate json @payload.json --rulepack vendor/linkedin-conversions-api
Try this failing payload in the playground. LinkedIn conversion with seconds instead of ms.
{"conversion":"urn:lla:llaPartnerConversion:1","conversionHappenedAt":1770000000,"user":{"userIds":[]}}
cargo install pixellint
·
npm install pixellint