Create a draft LinkedIn Ads campaign with HireOtto

Create a reviewable LinkedIn Ads campaign from your AI client without handing activation over to the model. HireOtto can validate a proposed campaign, create or reuse a campaign group, create an ad set, upload or reuse an image, and create a single-image Direct Sponsored Content ad. The safe sequence is: verify access → resolve targeting → estimate audience size → prepare the image → validate the complete hierarchy → create as drafts → read back → preview in Campaign Manager → verify tracking → activate after approval

​

What this workflow can change

This guide uses both read and write actions. Creation defaults to draft behavior, but a LinkedIn draft is only a platform status. It is not a substitute for a human review of the objective, audience, budget, schedule, creative, destination, measurement, and Page identity.

​

Before you start

You need:

• An MCP-capable AI client connected to https://linkedinads.hireotto.com/mcp.
• A LinkedIn identity with access to the intended Campaign Manager account.
• A role with sufficient write permission. Viewer access is read-only.
• Access to the LinkedIn Page or advertiser identity used by the ad when the workflow requires it.
• An approved objective, audience, budget, schedule, landing page, copy, image, and tracking plan.
• Enough HireOtto credits for validation, image upload, and creation.

LinkedIn Ads is available on Free, Starter, Pro, and Agency. The default LinkedIn profile is available on every plan. Additional named profiles require Agency or enabled Enterprise access. Confirm the exact account ID and currency before preparing budgets. Do not select an account from its display name alone.

​

1. Prepare a complete campaign brief

Give the AI client the decisions it cannot safely infer:

• Business objective and the one outcome the campaign should optimize for.
• Offer and landing page.
• Campaign group and ad-set names.
• Included and excluded audience logic.
• Daily or total budget, account currency, and schedule.
• Ad format, bid approach, and optimization goal.
• Introductory text, headline, call to action, alt text, and image.
• The LinkedIn Page or advertiser identity that should appear.
• The conversion action and how it will be tested.
• The person who can approve activation.

Do not ask HireOtto to choose the business objective or budget from account data alone. Reporting can inform those decisions, but it does not define the campaign’s commercial job.

​

2. Resolve targeting before creation

Use targeting discovery to convert marketer-friendly audience ideas into valid LinkedIn entities. Review every match and keep the exact URNs returned by LinkedIn. Then estimate the combined audience with the intended inclusions and exclusions. Audience size is a delivery guardrail, not a quality score or reach forecast. LinkedIn can round counts, suppress details, and deliver to fewer members than the estimate. Use locations or profile locations for geography. HireOtto adds interface-language targeting only when you explicitly provide languages or interfaceLocales. An explicit interface locale must contain exactly one value and must match the ad-set locale.

​

3. Reuse or upload an image

For the supported single-image path, the creative needs an image URN whose LinkedIn processing status is AVAILABLE. Start by listing recent active Media Library assets. Reuse an existing approved asset when possible. If the image is not already available, use the interactive upload tool in ChatGPT or Claude web or Desktop. It accepts JPG, PNG, and GIF files. The upload interface is not currently available in Claude Code CLI or the Claude Code VS Code extension. Programmatic byte upload is available when the client can read and encode the original file. The decoded image must be no larger than 8 MiB, and only image/jpeg, image/png, and image/gif are accepted. Do not paste base64 into chat. If an upload times out, list recent assets before retrying so you do not create a duplicate.

​

4. Choose the hierarchy workflow

Use create_linkedin_campaign when you want to validate or create the campaign group, ad set, and optional creatives in order. You can either:

• Reuse an existing campaign group by supplying its ID.
• Create a new campaign group from settings you provide.

Use create_linkedin_ads_entities when you need to create only one object or recover from a failure after a parent object already exists.

​

Campaign-group inputs

​

Ad-set inputs and defaults

An ad set requires a parent campaign group, name, targeting, and at least one budget. For the current image-led path, use SPONSORED_UPDATES with the appropriate standard-update format. Sponsored Content, Dynamic Ads, and Lead Generation require an associated advertiser entity. HireOtto normally resolves it from the selected ad account. If it cannot, verify the account’s advertiser identity and your Page access instead of inventing an organization or person URN. Additional platform rules apply:

• Dynamic Ads require both daily and total budgets plus an ad format.
• Connected TV requires offsite delivery.
• Lead Generation cannot enable offsite delivery.
• Changing a fixed ad format requires a new ad set.

​

Single-image creative inputs and defaults

The supported first-class path is a normal single-image Direct Sponsored Content ad. Supported CTA labels include APPLY, DOWNLOAD, VIEW_QUOTE, LEARN_MORE, SIGN_UP, SUBSCRIBE, REGISTER, JOIN, ATTEND, REQUEST_DEMO, SEE_MORE, UNLOCK_FULL_DOCUMENT, BUY_NOW, and SHOP_NOW. This workflow does not create LinkedIn Lead Gen Forms and does not upload video or document ads. It also does not validate the final visual rendering.

​

5. Validate the complete hierarchy

Set validate_only=true before an unfamiliar create. Validation normalizes the proposed request and checks HireOtto’s supported rules without sending a create request to LinkedIn. For an ad set, it also resolves the supplied targeting URNs. For the first-class image path, it confirms that the image is available. Validation does not reserve IDs or guarantee that a later write will pass. LinkedIn still checks permissions, Page access, budgets, dates, account state, and lifecycle rules when the real create runs. Review the normalized output field by field. Pay particular attention to:

• Account ID and currency.
• Campaign-group and ad-set names.
• Objective, format, cost type, bid strategy, and optimization goal.
• Daily and total budget ownership.
• Start and end dates.
• Complete targeting inclusions and exclusions.
• Locale and any explicit interface-language targeting.
• Page identity, image status, destination, CTA, and alt text.
• Draft statuses for every new object.

​

6. Create the approved objects as drafts

After approval, run the same reviewed configuration with validate_only=false and explicitly require draft statuses. The full hierarchy create costs 10 HireOtto credits after success. It can create a new campaign group or reuse an existing one, then create the ad set and creative in order. For a single object, validation costs 1 credit and a successful create costs 5 credits. A successful image upload costs 5 credits. A full hierarchy validation costs 1 credit; a successful full hierarchy create costs 10 credits. Credits are deducted only after a successful charged action. Agency has unlimited credits, but LinkedIn permissions and lifecycle restrictions still apply.

​

7. Inspect the saved hierarchy

A success response is not verification. Read the saved objects back from LinkedIn and compare the live values with the approved configuration. Then open Campaign Manager to confirm:

• The ad renders correctly on the intended Page identity.
• The image crop, headline, introductory text, CTA, and destination are correct.
• The account has no billing, policy, or serving warning.
• The conversion action and Insight Tag plan are appropriate.

Creating a creative does not install or test the LinkedIn Insight Tag, Google Tag Manager, or the landing page. Configuration inspection cannot prove that a tag fires in a browser. Test the real conversion path separately before activation.

​

Partial creation and recovery

The full hierarchy workflow is not transactional. If an ad set or creative fails, a campaign group or ad set created earlier in the sequence remains in LinkedIn. Do not blindly rerun the full request. That can create duplicate parents.

1. Save every ID in partial_result.
2. Read the live hierarchy.
3. Identify the first object that failed.
4. Correct and validate only that object.
5. Resume with create_linkedin_ads_entities using the existing parent ID.
6. Read the new object back.

Eligible draft ad sets and creatives can be deleted deliberately. Non-draft objects may require a different lifecycle action. Always inspect the current status before requesting deletion.

​

Controlled updates and activation

HireOtto supports selected updates to campaign groups, ad sets, and creatives, plus eligible draft deletion. Keep activation separate from budget, targeting, creative, date, and bid changes so every decision remains reviewable. For targeting, a partial friendly include or exclude map sent through a general ad-set update can replace the existing targeting. Use the additive-exclusion action when you only want to add exclusions. For any broader targeting change, read the complete current criteria, resolve new entities, estimate the revised audience, and review the full diff. LinkedIn can reject activation when the parent remains in draft, the schedule is stale, the account cannot serve, the creative is not eligible, or the connected role lacks permission. validate_only=true does not override those platform checks.

​

Common failures

​

Current limits

• The first-class creation path is a normal single-image Direct Sponsored Content ad.
• Lead Gen Form creation is not supported.
• Image upload does not imply video or document-ad upload support.
• Fixed ad formats cannot be swapped after ad-set creation.
• Campaign Manager remains the final source for rendering, Page identity, policy review, billing, serving warnings, and activation state.
• Image processing, account permissions, lifecycle transitions, and LinkedIn-side validation can still fail after local validation.
• Creating an ad does not prove that the destination or conversion tracking works.

​

Recommended review checklist

• Correct ad account ID, name, currency, role, and write capability
• Approved objective and campaign hierarchy
• Valid targeting URNs and viable audience estimate
• Correct budget owner, amount, currency, and schedule
• Compatible format, bid strategy, cost type, and optimization goal
• Available image and approved Page identity
• Approved copy, headline, destination, CTA, and alt text
• Every new object created as DRAFT
• Returned IDs saved and live values read back
• Creative previewed in Campaign Manager
• Landing page and tracking tested separately
• Named human approval recorded before activation

​

Related documentation

• Connect LinkedIn Ads
• LinkedIn Ads MCP tools reference
• Discover LinkedIn Ads targeting and estimate audience size
• Analyze LinkedIn Ads performance and professional demographics
• HireOtto feature and entitlement matrix
• Troubleshoot HireOtto connections and permissions