Hello Zernio team,
We found what appears to be an issue with the coverPhoto support for Meta Instant Forms.
According to the Zernio changelog and SDK, contextCard.coverPhoto is supported when creating a Meta Lead Form. However, when we send a form with a cover image, Zernio converts it into:
context_card.cover_photo
Meta then rejects the request with:
Invalid keys "cover_photo" were found in param "context_card".
The full platform error is:
type: OAuthException
code: 100
message: Invalid keys "cover_photo" were found in param "context_card".
We also verified the image upload separately.
The image is successfully uploaded through /v1/ads/images and we receive:
a valid Meta Ad Image hash
a Meta-hosted image URL
an AdImage node ID
So the issue does not appear to be the image upload itself.
The main problem seems to be the mapping of Zernio's public contextCard.coverPhoto field to Meta's Lead Form API.
From our testing, Meta expects the cover image to be handled as the form-level cover_photo parameter during form creation, while context_card.cover_photo is not accepted as a writable field in this request.
At the moment, this means that any Instant Form created through Zernio with a cover image fails completely.
This is important for our use case because we are building an automated Meta advertising platform for Chinese factories. Many of our factory customers need to create complete Instant Forms directly inside our platform, including:
cover image
introduction/context card
questions
privacy policy
thank-you page
lead follow-up
We are trying to avoid requiring factory users to open Meta Ads Manager and manually create or edit forms, since many of them are not familiar with Meta's advertising tools.
Could you please confirm whether this is a Zernio mapping issue and update the Meta Lead Form integration so that contextCard.coverPhoto is sent using the correct Meta form creation parameter?
We have a minimal reproducible example including the sanitized request payload and full Meta platformError, and we can provide it if needed.
Thanks!
Please authenticate to join the conversation.
Completed
Feature Request
19 days ago

alan xu
Get notified by email when there are changes.
Completed
Feature Request
19 days ago

alan xu
Get notified by email when there are changes.