Publications

Request publication

One article, one or more publications.

Payment ambiguity is never guessed. When several owned packages cover the same site, the request is rejected with 409 and the list of options; the integration picks one and retries with packageTypeId. Guessing would consume the wrong package, and that cannot be undone.

Required scope: PUBLICATIONS_WRITE.

post/partner/publications

Request

  • Base URL: https://app.comunicate.eu/api/v1
  • URL: https://app.comunicate.eu/api/v1/partner/publications
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.comunicate.eu/api/v1/oauth/authorize, token URL https://app.comunicate.eu/api/v1/oauth/token, scopes: PUBLICATIONS_WRITE)

Request body

articleIdstring uuid required

The article to publish.

siteIdsstring[] required

The publications chosen from the catalogue.

campaignTypestring required

The campaign type. Must be among the site's acceptedCampaigns.

packageTypeIdstring uuid

Which package pays, when several cover the site.

licenseNumberstring

The operator’s ONJN gambling licence. Required when campaignType is "CASINO" — gambling advertising must display it, and the platform writes it onto the article itself before sending it.

extrasBySiteobject

Extras requested per site — "HOMEPAGE_PLACEMENT", "FACEBOOK_SHARE", at most both. The key is siteId, the value a list of types; each one requested must have an active offer on that site (see GET /partner/catalog), otherwise the request is rejected.

scheduledForstring date-time

When it should go live, if not immediately.

Response

OK

object required

Changes

No recorded changes to this operation across all 1 revision of this API.