changedInput schema / properties / body / properties / adBudgetOptimization / example
Previous value: -"MAX_REACH"New value: +"MAXIMUM_DELIVERY"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / adCampaignGroupId / description
Previous value: -"Parent campaign group identifier"New value: +"Parent campaign group id"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / adCampaignGroupId / example
Previous value: -"cg_abc123"New value: +"6a840c5a1c2e6acf77b1d258"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / adCampaignId / description
Previous value: -"Parent ad campaign identifier"New value: +"Parent ad campaign id"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / adCampaignId / example
Previous value: -"camp_abc123"New value: +"6a840c7b1c2e6acf77b1d2a5"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / adId / description
Previous value: -"LinkedIn ad resource ID"New value: +"LinkedIn ad id, set once published"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / adId / example
Previous value: -"12345678"New value: +"1554451156"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / callToActionLabel / description
Previous value: -"Call to action label"New value: +"Call-to-action button label"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / callToActionLabel / example
Previous value: -"LEARN_MORE"New value: +"APPLY"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / contentReferenceString / description
Previous value: -"Content reference URN for boosted posts"New value: +"URN of the underlying LinkedIn share, set once published"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / contentReferenceString / example
Previous value: -"urn:li:share:123"New value: +"urn:li:share:7495384246371512320"
addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / createdAt
Added value: +{
+ "description": "Created at",
+ "example": "2026-08-18T07:40:43.385Z",
+ "type": "string"
+}
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / description / example
Previous value: -"Join thousands who already made the switch"New value: +""
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / destinationFormId / description
Previous value: -"Destination lead-gen form ID"New value: +"Lead form id when the ad routes to a form instead of a URL"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / destinationFormId / example
Previous value: -"form_abc123"New value: +""
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / destinationUrl / description
Previous value: -"Click-through destination URL"New value: +"Click destination"
removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / headline
Removed value: -{
- "description": "Ad headline",
- "example": "Your next career move starts here",
- "type": "string"
-}
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / id / example
Previous value: -"ad_abc123"New value: +"6a840c7b1c2e6acf77b1d2a8"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / introductoryText / description
Previous value: -"Introductory ad copy shown above the creative"New value: +"Body copy above the creative"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / introductoryText / example
Previous value: -"Check out our summer sale!"New value: +"Grow your pipeline this quarter"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / linkedInError / description
Previous value: -"LinkedIn API error message"New value: +"Rejection or publish error from LinkedIn. Empty string when there is none."
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / linkedInError / example
Previous value: -"Ad rejected by policy"New value: +""
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / description
Previous value: -"Ad creative media"New value: +"Creative media"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / example
Previous value: -[
- {
- "src": "https://example.com/image.jpg",
- "type": "image"
- }
-]New value: +[
+ {
+ "_id": "6a840c881c2e6acf77b1d3c9",
+ "destinationUrl": "example.com",
+ "fileSizeBytes": 1066210,
+ "headline": "Try it free",
+ "name": "creative.png",
+ "src": "https://staging.files.leadconnectorhq.com/file/abc/def.png",
+ "type": "image",
+ "urn": "urn:li:image:D5610AQEjSUtmzK0rjw"
+ }
+]
addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / _id
Added value: +{
+ "description": "Mongo subdocument id. Note `_id`, not `id` — the transform applies to the top-level document only.",
+ "example": "6a840c881c2e6acf77b1d3c9",
+ "type": "string"
+}
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / destinationUrl / description
Previous value: -"Click-through destination URL"New value: +"Click destination for this media"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / destinationUrl / example
Previous value: -"https://example.com"New value: +"example.com"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / fileSizeBytes / example
Previous value: -102400New value: +1066210
removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / frames
Removed value: -{
- "description": "Video frame URLs",
- "example": [
- "https://example.com/frame1.jpg"
- ],
- "items": {
- "type": "string"
- },
- "type": "array"
-}
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / headline / description
Previous value: -"Media headline"New value: +"Headline shown with this media"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / headline / example
Previous value: -"Get started today"New value: +"Try it free"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / name / description
Previous value: -"Media name"New value: +"Original file name"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / name / example
Previous value: -"ad_image.jpg"New value: +"creative.png"
removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / selectedPoster
Removed value: -{
- "description": "Selected poster frame index",
- "example": 0,
- "type": "number"
-}
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / src / description
Previous value: -"Media source URL"New value: +"Source URL of the uploaded file"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / src / example
Previous value: -"https://example.com/image.jpg"New value: +"https://staging.files.leadconnectorhq.com/file/abc/def.png"
removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / thumbnailUrl
Removed value: -{
- "description": "Thumbnail URL",
- "example": "https://example.com/thumb.jpg",
- "type": "string"
-}
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / type / description
Previous value: -"Media type"New value: +"Media kind"
removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / type / enum
Removed value: -[
- "video",
- "image"
-]
addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / properties / urn
Added value: +{
+ "description": "LinkedIn media URN, set once the asset has been uploaded. Observed present on reads but absent from the upsert response, which also returns a new `_id` for the same media — the subdocument appears to be replaced on save.",
+ "example": "urn:li:image:D5610AQEjSUtmzK0rjw",
+ "type": "string"
+}
addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / required
Added value: +[
+ "type",
+ "src",
+ "name"
+]
addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / media / items / title
Added value: +"LinkedInAdMediaDTO"
removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / meta
Removed value: -{
- "description": "Additional ad metadata",
- "example": {
- "tone": "professional"
- },
- "type": "object"
-}
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / name / example
Previous value: -"Summer Sale Ad"New value: +"Ad 1"
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / publishingStatus / description
Previous value: -"Ad publishing status"New value: +"Publishing status"
removedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / publishingStatus / enum
Removed value: -[
- "DRAFT",
- "SCHEDULED",
- "PUBLISHED",
- "PUBLISHING",
- "FAILED",
- "IN_REVIEW",
- "PAUSED",
- "ARCHIVED",
- "WITH_ISSUES",
- "REJECTED"
-]
changedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / publishingStatus / example
Previous value: -"PUBLISHED"New value: +"FAILED"
addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / properties / updatedAt
Added value: +{
+ "description": "Updated at",
+ "example": "2026-08-18T07:45:04.624Z",
+ "type": "string"
+}
addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / required
Added value: +[
+ "id",
+ "name",
+ "adCampaignId",
+ "adCampaignGroupId",
+ "publishingStatus",
+ "linkedInError",
+ "introductoryText",
+ "description",
+ "destinationUrl",
+ "destinationFormId",
+ "callToActionLabel",
+ "media",
+ "createdAt",
+ "updatedAt"
+]
addedInput schema / properties / body / properties / adCampaigns / items / properties / ads / items / title
Added value: +"LinkedInAdDTO"
changedInput schema / properties / body / properties / adCampaigns / items / properties / audience / allOf
Previous value: -[
- {
- "properties": {
- "geoLocations": {
- "description": "Geographic location targets",
- "example": [
- {
- "facetUrn": "urn:li:adTargetingFacet:locations",
- "name": "India",
- "selectionType": "include",
- "urn": "urn:li:geo:102713980"
- }
- ],
- "items": {
- "properties": {
- "facetUrn": {
- "description": "Facet URN",
- "example": "urn:li:adTargetingFacet:locations",
- "type": "string"
- },
- "name": {
- "description": "Location display name",
- "example": "India",
- "type": "string"
- },
- "selectionType": {
- "description": "Selection type",
- "enum": [
- "include",
- "exclude"
- ],
- "example": "include",
- "type": "string"
- },
- "urn": {
- "description": "Location URN",
- "example": "urn:li:geo:12321321",
- "type": "string"
- }
- },
- "required": [
- "name",
- "urn",
- "facetUrn",
- "selectionType"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "targetAudience": {
- "allOf": [
- {
- "properties": {
- "exclude": {
- "description": "Excluded targeting attributes",
- "example": [],
- "items": {
- "items": {
- "properties": {
- "categoryName": {
- "description": "Category name",
- "example": "Location",
- "type": "string"
- },
- "facet": {
- "description": "Facet identifier",
- "example": "urn:li:adTargetingFacet:locations",
- "type": "string"
- },
- "name": {
- "description": "Display name",
- "example": "United States",
- "type": "string"
- },
- "urn": {
- "description": "Targeting attribute URN",
- "example": "urn:li:geo:103644278",
- "type": "string"
- }
- },
- "required": [
- "urn",
- "name",
- "categoryName",
- "facet"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "type": "array"
- },
- "include": {
- "description": "Included targeting attributes (groups of ANDed attributes, ORed together)",
- "example": [
- [
- {
- "categoryName": "Location",
- "facet": "urn:li:adTargetingFacet:locations",
- "name": "United States",
- "urn": "urn:li:geo:103644278"
- }
- ]
- ],
- "items": {
- "items": {
- "properties": {
- "categoryName": {
- "description": "Category name",
- "example": "Location",
- "type": "string"
- },
- "facet": {
- "description": "Facet identifier",
- "example": "urn:li:adTargetingFacet:locations",
- "type": "string"
- },
- "name": {
- "description": "Display name",
- "example": "United States",
- "type": "string"
- },
- "urn": {
- "description": "Targeting attribute URN",
- "example": "urn:li:geo:103644278",
- "type": "string"
- }
- },
- "required": [
- "urn",
- "name",
- "categoryName",
- "facet"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "type": "array"
- }
- },
- "type": "object"
- }
- ],
- "description": "Target audience attribute selections",
- "example": {
- "exclude": [],
- "include": []
- }
- }
- },
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "geoLocations": {
+ "description": "Geographic location targets",
+ "example": [
+ {
+ "facetUrn": "urn:li:adTargetingFacet:locations",
+ "name": "India",
+ "selectionType": "include",
+ "urn": "urn:li:geo:102713980"
+ }
+ ],
+ "items": {
+ "properties": {
+ "facetUrn": {
+ "description": "Facet URN",
+ "example": "urn:li:adTargetingFacet:locations",
+ "type": "string"
+ },
+ "name": {
+ "description": "Location display name",
+ "example": "India",
+ "type": "string"
+ },
+ "selectionType": {
+ "description": "Selection type",
+ "enum": [
+ "include",
+ "exclude"
+ ],
+ "example": "include",
+ "type": "string"
+ },
+ "urn": {
+ "description": "Location URN",
+ "example": "urn:li:geo:12321321",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "urn",
+ "facetUrn",
+ "selectionType"
+ ],
+ "title": "GeoLocationDTO",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "targetAudience": {
+ "allOf": [
+ {
+ "properties": {
+ "exclude": {
+ "description": "Excluded targeting attributes. Same nested-array shape as `include` — outer entries are AND-ed, inner entries are OR-ed. Omit or send an empty array when nothing is excluded.",
+ "example": [
+ [
+ {
+ "categoryName": "Skill",
+ "facet": "urn:li:adTargetingFacet:skills",
+ "name": "JavaScript",
+ "urn": "urn:li:skill:1"
+ }
+ ]
+ ],
+ "items": {
+ "items": {
+ "properties": {
+ "categoryName": {
+ "description": "Category name",
+ "example": "Location",
+ "type": "string"
+ },
+ "facet": {
+ "description": "Facet identifier",
+ "example": "urn:li:adTargetingFacet:locations",
+ "type": "string"
+ },
+ "name": {
+ "description": "Display name",
+ "example": "United States",
+ "type": "string"
+ },
+ "urn": {
+ "description": "Targeting attribute URN",
+ "example": "urn:li:geo:103644278",
+ "type": "string"
+ }
+ },
+ "required": [
+ "urn",
+ "name",
+ "categoryName",
+ "facet"
+ ],
+ "title": "SelectedAttributeDTO",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "include": {
+ "description": "Included targeting attributes (groups of ANDed attributes, ORed together)",
+ "example": [
+ [
+ {
+ "categoryName": "Location",
+ "facet": "urn:li:adTargetingFacet:locations",
+ "name": "United States",
+ "urn": "urn:li:geo:103644278"
+ }
+ ]
+ ],
+ "items": {
+ "items": {
+ "properties": {
+ "categoryName": {
+ "description": "Category name",
+ "example": "Location",
+ "type": "string"
+ },
+ "facet": {
+ "description": "Facet identifier",
+ "example": "urn:li:adTargetingFacet:locations",
+ "type": "string"
+ },
+ "name": {
+ "description": "Display name",
+ "example": "United States",
+ "type": "string"
+ },
+ "urn": {
+ "description": "Targeting attribute URN",
+ "example": "urn:li:geo:103644278",
+ "type": "string"
+ }
+ },
+ "required": [
+ "urn",
+ "name",
+ "categoryName",
+ "facet"
+ ],
+ "title": "SelectedAttributeDTO",
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "type": "array"
+ }
+ },
+ "title": "TargetAudienceDTO",
+ "type": "object"
+ }
+ ],
+ "description": "Target audience attribute selections",
+ "example": {
+ "exclude": [
+ [
+ {
+ "categoryName": "Skill",
+ "facet": "urn:li:adTargetingFacet:skills",
+ "name": "JavaScript",
+ "urn": "urn:li:skill:1"
+ }
+ ]
+ ],
+ "include": [
+ [
+ {
+ "categoryName": "Location",
+ "facet": "urn:li:adTargetingFacet:locations",
+ "name": "United States",
+ "urn": "urn:li:geo:103644278"
+ }
+ ]
+ ]
+ }
+ }
+ },
+ "title": "AudienceDTO",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / adCampaigns / items / properties / audience / example / geoLocations
Previous value: -[]New value: +[
+ {
+ "facetUrn": "urn:li:adTargetingFacet:locations",
+ "name": "United States",
+ "selectionType": "include",
+ "urn": "urn:li:geo:103644278"
+ }
+]
changedInput schema / properties / body / properties / adCampaigns / items / properties / audience / example / targetAudience / exclude
Previous value: -[]New value: +[
+ {
+ "facet": "urn:li:adTargetingFacet:staffCountRanges",
+ "values": [
+ "urn:li:staffCountRange:SIZE_1"
+ ]
+ }
+]
changedInput schema / properties / body / properties / adCampaigns / items / properties / audience / example / targetAudience / include
Previous value: -[]New value: +[
+ [
+ {
+ "categoryName": "Skill",
+ "facet": "urn:li:adTargetingFacet:skills",
+ "name": "JavaScript",
+ "urn": "urn:li:skill:1"
+ }
+ ]
+]
changedInput schema / properties / body / properties / adCampaigns / items / properties / locale / allOf
Previous value: -[
- {
- "properties": {
- "country": {
- "description": "Country code",
- "example": "US",
- "type": "string"
- },
- "language": {
- "description": "Language code",
- "example": "en",
- "type": "string"
- }
- },
- "required": [
- "country",
- "language"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "country": {
+ "description": "Country code",
+ "example": "US",
+ "type": "string"
+ },
+ "language": {
+ "description": "Language code",
+ "example": "en",
+ "type": "string"
+ }
+ },
+ "required": [
+ "country",
+ "language"
+ ],
+ "title": "LocaleDTO",
+ "type": "object"
+ }
+]
changedInput schema / properties / body / properties / adCampaigns / items / properties / unitCost / allOf
Previous value: -[
- {
- "properties": {
- "amount": {
- "description": "Bid amount in currency minor units",
- "example": 500,
- "type": "number"
- }
- },
- "required": [
- "amount"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "amount": {
+ "description": "Bid amount (major currency units)",
+ "example": 5,
+ "type": "number"
+ }
+ },
+ "required": [
+ "amount"
+ ],
+ "title": "UnitCostDTO",
+ "type": "object"
+ }
+]
addedInput schema / properties / body / properties / adCampaigns / items / title
Added value: +"AdCampaignDTO"
changedInput schema / properties / body / properties / budget / allOf
Previous value: -[
- {
- "properties": {
- "amount": {
- "description": "Budget amount (currency minor units)",
- "example": 10000,
- "type": "number"
- },
- "budgetType": {
- "description": "LinkedIn campaign budget type",
- "enum": [
- "DAILY",
- "LIFETIME"
- ],
- "example": "DAILY",
- "type": "string"
- },
- "scheduleEndDate": {
- "description": "Schedule end date (ISO 8601)",
- "example": "2025-12-31",
- "type": "string"
- },
- "scheduleStartDate": {
- "description": "Schedule start date (ISO 8601)",
- "example": "2025-01-01",
- "type": "string"
- }
- },
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "amount": {
+ "description": "Budget amount in the account currency",
+ "example": 30,
+ "type": "number"
+ },
+ "budgetType": {
+ "description": "Budget cadence",
+ "enum": [
+ "DAILY",
+ "LIFETIME"
+ ],
+ "example": "DAILY",
+ "type": "string"
+ },
+ "scheduleEndDate": {
+ "description": "Schedule end",
+ "example": "2026-09-17T07:40:10.110Z",
+ "type": "string"
+ },
+ "scheduleStartDate": {
+ "description": "Schedule start",
+ "example": "2026-08-18T07:40:10.110Z",
+ "type": "string"
+ }
+ },
+ "required": [
+ "budgetType",
+ "amount"
+ ],
+ "title": "LinkedInBudgetDTO",
+ "type": "object"
+ }
+]
addedInput schema / properties / body / properties / customValueMappings
Added value: +{
+ "description": "User-provided overrides for custom_values merge tags used in ad copy",
+ "example": {
+ "{{ custom_values.pet_name }}": "Fluffy"
+ },
+ "type": "object"
+}
addedInput schema / properties / body / title
Added value: +"AdCampaignGroupDataDTO"