# Publish a service

**Steps to publish a service:**

<figure><img src="/files/lwE4EXeqL6MnQ9i7gLxX" alt=""><figcaption></figcaption></figure>

***

### 1. Sign up

**Sign Up** on [apinity Xplore](https://marketplace.apinity.io) with your e-mail address and log in.

### 2. Create a Workspace

{% hint style="info" %}
A *workspace* represents your company, organization or team in the marketplace.&#x20;

You will manage your services and subscriptions from the workspace.
{% endhint %}

In the top-right corner, create a Workspace by clicking on **Create Workspace** and filling out the form.

<img src="/files/d3o85xdwlCTDW3fcp3x8" alt="(blue star)" data-size="line"> You now have full access to the apinity marketplace.

### 3a. Define APIs

{% hint style="info" %}
An *API* is the technical representation of a product.

APIs can belong to one or more Services.
{% endhint %}

* Go to **My Hub** > **APIs**.
* Click **Upload APIs** to upload an OAS/swagger definition file in JSON format.
* Click **Assign Access Control** to define authentication method(s) for your API(s).

### 3b. Create a Service

{% hint style="info" %}
A *service* is the marketing representation of a product and its features.&#x20;

It can be created parallelly to defining the APIs.
{% endhint %}

* Go to **My Hub**.
* Start service creation by clicking on **Add Service**.
* Specify a Service Name and click **Add Service**.
* On the next page, fill out the *Overview* and the *Product Description*. Mandatory fields are indicated with <mark style="color:red;">\*</mark>.

### 4. Create a Plan

{% hint style="info" %}
A *plan* is the commercial representation of a service. In a plan, you associate APIs to the service, and define the pricing and limits of consumption.
{% endhint %}

* In the top-right corner, click on **Continue to Step 2: Plans**. On the next page, click on **Add a Plan**.
* Define the plan's Name and **Service Type**.
* Using the available tabs, proceed to:
  * Define the plan's **Permissions**.
  * **Assign APIs** to the plan.
  * Define **Limits and Pricing**.
  * Upload a legal **Contract** for your provided service.

### 5. Publish

* When you have filled in all the required information, click **Proceed to Publishing** in the top-right corner.
* Click on Submit plans in the left menu. In the Publish Service dialog, select the items you are ready to submit. By clicking **Submit**, you agree to the [Terms of Service](https://marketplace.apinity.io/terms-and-conditions).

<img src="/files/d3o85xdwlCTDW3fcp3x8" alt="(blue star)" data-size="line"> Your service has now been submitted for review. This review can take a few business days. You will receive an email once the review is finished and your service is available.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.apinity.io/quick-start/publish-your-first-service-quick.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.