# Add a Plan

Having created a Service, click on **Continue to Step 2: Plans.** On the new page, you will find the **Add a Plan** button. Here you can add one or multiple plans for your Service.

Once you click on **Add a Plan**, you will be brought to a new page with several tabs. Please fill out the relevant information in each tab.

<figure><img src="https://416365155-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVziGvOGJssgAUojsPRj%2Fuploads%2F4f5ultfgt9j1dSyxm5YF%2Fimage.png?alt=media&#x26;token=2d0aa526-0b0f-4b6b-a096-8e8d7044cef2" alt=""><figcaption></figcaption></figure>

### General <a href="#addaplan-step2.1servicetype" id="addaplan-step2.1servicetype"></a>

Define your plan's name, service type, and approval process.

* When defining your **Plan Name**, please note that the plan name **cannot be changed** after the plan has been published.
* Mark the **Set as a Demo** checkbox if appropriate. A demo plan is a free plan to which users can subscribe so that they can try out your service (for example, for testing and integration purposes). Demo plans are highlighted in the marketplace. \
  Setting a [rate limit](#limits) under *Limits and Pricing* is mandatory for Demo plans.
* If your service will be exclusively consumed via API calls, select the Service type **API**.
* For independent SaaS offerings, which will be consumed differently by your customers (e.g. via a combination of web application, mobile application, e-mail, etc.), select the Service type **Application**.
* You can enable **Subscription Approval** if you would like tighter control over your subscribers. This is Off by default, allowing everyone to subscribe to your publicly available plans. You will find the list of your subscribers and their contact details in the Subscribers section, irrespective of this setting.&#x20;

{% hint style="info" %}
Application plans have no assigned APIs and limited pricing options.&#x20;

The *cursive* sections below only apply to API plans.
{% endhint %}

### Permissions <a href="#addaplan-step2.2visibility" id="addaplan-step2.2visibility"></a>

Decide whether your plan is public or restricted.

* **Selected Workspaces** - can be offered individually to other Workspaces, otherwise hidden from the catalog. Your own workspace is included by default. If you don't add any further workspaces, the Plan will be private to your own workspace.
* **All Workspaces** - available for anyone to consume, publicly listed in the marketplace catalog.&#x20;

### *Assign API to Plan* <a href="#addaplan-step2.3access-onlyforservicetypeapi" id="addaplan-step2.3access-onlyforservicetypeapi"></a>

Here you can select one or more APIs from your [API Collection](https://docs.apinity.io/step-by-step/add-an-api#api-collection). The *Limits and Pricing* section will parse the assigned APIs in order to provide granular configuration per endpoint and transactions.

### *Limits and pricing* / Pricing <a href="#addaplan-step2.5limitsandpricing-pricing" id="addaplan-step2.5limitsandpricing-pricing"></a>

#### *Transaction Configuration*

A transaction is a unit of measurement that can be used for your offered services' billing purposes. You can create multiple transactions for one service and refer to them while configuring your pricing plan.

* Click **Add Transaction**.
* Specify a Transaction Name.
* Select the Transaction Recognition Type (**Single Request** or **Response Header**).
  * **Single Request** will count any request to a certain endpoint, followed by a specified server response (e.g. 200-203 as successful requests).
  * **Response Headers** allow you to configure multiple endpoints. An additional ID needs to be added as a header. A response from any of the endpoints including this additional header value will be counted as a transaction.
* Select the appropriate Endpoint(s).
* For Single Request, define the HTTP Response Codes; for Response Header, define the Header Name and Value.
* Click **Add Transaction** to finish adding the transaction.

#### *Limits*

Limits can be defined for your pricing plan. E.g. "100 Requests per month."

* Click **Add Limit**.
* Under Amount, specify the maximum amount for this limit
* Under Unit, Requests are specified as the unit of measurement for the limit
* Under Period, specify the time interval for the limit.

#### Pricing

Define prices, such as an overall periodical fee, or a fee for each unit or for each transaction.

{% tabs %}
{% tab title="API Plans" %}

* **Price per period**:
  * Under Amount, define the price that should be billed per period.
  * Under Period, select the duration of one period.
* **Price per unit**:
  * Under Amount, define the price for one unit.
  * Under Unit, Requests are specified as the unit of measurement.
  * Under Threshold, you can optionally define a starting point for tiered pricing. (e.g. a threshold of 50 means that the pricing will be applied from the 50th request onwards)
* **Price per transaction**:
  * Under Amount, define the price for one transaction.
  * Under Transaction, select the transaction for which this price should be billed.
  * Under Threshold, you can optionally define a starting point for tiered pricing. (e.g. a threshold of 50 means that the pricing will be applied from the 50th transaction onwards)
    {% endtab %}

{% tab title="Application Plans" %}

* **Price per period**:
  * Under Amount, define the price that should be billed per period.
  * Under Period, select the duration of one period.
* **Price per user**:
  * Under Amount, define the price for one user.
  * Under Threshold, define the lower limit of the threshold to which this price applies.
* **Price per setup**:
  * Under Amount, define the price for one setup.
    {% endtab %}
    {% endtabs %}

### Contract <a href="#addaplan-step2.6contract" id="addaplan-step2.6contract"></a>

Upload a contract that describes the terms and conditions of the service you are providing.

#### Continue with Preview & Publishing <a href="#addaplan-continuewithpreview-and-publishing" id="addaplan-continuewithpreview-and-publishing"></a>

When you completed the service description and the setup of the plan(s), continue with publishing: [Preview & Publish your Services and Plans](https://docs.apinity.io/step-by-step/provide-a-service-on-the-marketplace/preview-and-publish-your-services-and-plans)