younifyd
Menu

Create Offering

Create an offering

POST/v2/subscriptions/offerings

Use it in a workflow

  1. Add a step and choose the Elastic Path connector.
  2. Pick the Create Offering action (under Subscriptions).
  3. Fill in the fields below, then reference the result from later steps as {{createOffering.response.data}}.

Request

Query parameters

filterstring (string)

Some Subscriptions API endpoints support filtering. For the general syntax, see [**Filtering**](/guides/Getting-Started/filtering), but you must go to a specific endpoint to understand the attributes and operators an endpoint supports.

Request body

Enter the body as JSON in the step's Body field.

dataobjectrequired
typestringrequired

One ofsubscription_offering

attributesobjectrequired3 fields
relationshipsobject1 fields
json
{
  "data": {
    "type": "subscription_offering",
    "attributes": {
      "name": "Magazine",
      "external_ref": "abc123",
      "description": "A lovely magazine that is published every month."
    },
    "relationships": {
      "proration_policy": {
        "type": "subscription_proration_policy",
        "id": "11111111-2222-3333-4444-555555555555"
      }
    }
  }
}

Response

Returns 201 with an object. Read it in later steps with {{createOffering.response.data.<field>}}.

dataobject
idstring (uuid)

The unique identifier.

typestringrequired

One ofsubscription_offering

attributesanyrequired
relationshipsany

Relationships are established between different subscription entities. For example, a plan and a pricing option are related to an offering, as both are attached to it.

metaobjectrequired3 fields
json
{
  "data": {
    "type": "subscription_offering",
    "attributes": null,
    "meta": {
      "external_plan_refs": [
        "97dddc65-eabd-45d8-b45b-2ece5cfc8c50"
      ],
      "owner": "store",
      "timestamps": {
        "updated_at": "2017-01-10T11:41:19.244842Z",
        "created_at": "2017-01-10T11:41:19.244842Z"
      }
    },
    "id": "11111111-2222-3333-4444-555555555555",
    "relationships": {
      "pricing-options": {
        "links": {
          "related": "/offerings/:offering-id/pricing-options",
          "self": "/offerings/:offering-id"
        },
        "data": {
          "type": "offering-pricing-option",
          "id": "625fe958-7b4b-40a0-a2c0-dbb8f31eec0d"
        }
      }
    }
  }
}

Need more? See the Elastic Path guide for connection setup and behaviour shared by every action.