pixellint

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

Hosts
api.linkedin.com
Paths
…/conversionEvents…
Vendor docs
learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api

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.missing
vendor.linkedin-conversions-api.body.conversion.empty
vendor.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.missing
vendor.linkedin-conversions-api.body.conversionHappenedAt.empty
vendor.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.missing
vendor.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.missing
vendor.linkedin-conversions-api.body.user.userIds[].idType.empty
vendor.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.missing
vendor.linkedin-conversions-api.body.user.userIds[].idValue.empty
vendor.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.empty
vendor.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[].empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.missing
vendor.linkedin-conversions-api.http.method.empty
vendor.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.missing
vendor.linkedin-conversions-api.http.path.empty
vendor.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.missing
vendor.linkedin-conversions-api.http.content_type.empty
vendor.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.missing
vendor.linkedin-conversions-api.http.body_encoding.empty
vendor.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.missing
vendor.linkedin-conversions-api.http.headers.authorization.empty
vendor.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.missing
vendor.linkedin-conversions-api.http.headers.linkedin-version.empty
vendor.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.missing
vendor.linkedin-conversions-api.http.headers.x-restli-protocol-version.empty
vendor.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.missing
vendor.linkedin-conversions-api.http.url.empty
vendor.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.missing
vendor.linkedin-conversions-api.http.firstName.empty
vendor.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.missing
vendor.linkedin-conversions-api.http.lastName.empty
vendor.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