> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://api-docs.papertracc.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api-docs.papertracc.com/_mcp/server.

# Create Vendor

POST https://api.papertracc.com/v1/profiles/vendors
Content-Type: application/json

Creates a vendor profile.

Reference: https://api-docs.papertracc.com/papertracc/profiles/vendors/create-vendor

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: collection
  version: 1.0.0
paths:
  /profiles/vendors:
    post:
      operationId: Create Vendor
      summary: Create Vendor
      description: Creates a vendor profile.
      tags:
        - vendors
      parameters:
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Profiles_Vendors_Create
                  Vendor_Response_201
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                email:
                  type: string
                  format: email
                phone:
                  type: string
                company_name:
                  type: string
                display_name:
                  type: string
                currency_code:
                  type: string
                billing_address:
                  $ref: >-
                    #/components/schemas/ProfilesVendorsPostRequestBodyContentApplicationJsonSchemaBillingAddress
                shipping_address:
                  $ref: >-
                    #/components/schemas/ProfilesVendorsPostRequestBodyContentApplicationJsonSchemaShippingAddress
              required:
                - type
                - email
                - phone
                - company_name
                - display_name
                - currency_code
                - billing_address
                - shipping_address
servers:
  - url: https://api.papertracc.com/v1
    description: Production
  - url: https://api.papertracc.com/rc-1
    description: Release Candidate 1
components:
  schemas:
    ProfilesVendorsPostRequestBodyContentApplicationJsonSchemaBillingAddress:
      type: object
      properties:
        city:
          type: string
        name:
          type: string
        phone:
          type: string
        state:
          type: string
        country:
          type: string
        post_code:
          type: string
        address_one:
          type: string
        country_code:
          type: string
      required:
        - city
        - name
        - phone
        - state
        - country
        - post_code
        - address_one
        - country_code
      title: ProfilesVendorsPostRequestBodyContentApplicationJsonSchemaBillingAddress
    ProfilesVendorsPostRequestBodyContentApplicationJsonSchemaShippingAddress:
      type: object
      properties:
        city:
          type: string
        name:
          type: string
        phone:
          type: string
        state:
          type: string
        country:
          type: string
        post_code:
          type: string
        address_one:
          type: string
        country_code:
          type: string
      required:
        - city
        - name
        - phone
        - state
        - country
        - post_code
        - address_one
        - country_code
      title: >-
        ProfilesVendorsPostRequestBodyContentApplicationJsonSchemaShippingAddress
    ProfilesVendorsPostResponsesContentApplicationJsonSchemaDataAccountsItems:
      type: object
      properties:
        bank:
          type: string
        code:
          type: string
        vat_id:
          type: string
          format: uuid
        is_default:
          type: boolean
        account_name:
          type: string
        currency_code:
          type: string
        account_number:
          type: string
      required:
        - bank
        - code
        - vat_id
        - is_default
        - account_name
        - currency_code
        - account_number
      title: >-
        ProfilesVendorsPostResponsesContentApplicationJsonSchemaDataAccountsItems
    ProfilesVendorsPostResponsesContentApplicationJsonSchemaDataBillingAddress:
      type: object
      properties:
        city:
          type: string
        name:
          type: string
        phone:
          type: string
        state:
          type: string
        country:
          type: string
        post_code:
          type: string
        address_one:
          type: string
        country_code:
          type: string
      required:
        - city
        - name
        - phone
        - state
        - country
        - post_code
        - address_one
        - country_code
      title: >-
        ProfilesVendorsPostResponsesContentApplicationJsonSchemaDataBillingAddress
    ProfilesVendorsPostResponsesContentApplicationJsonSchemaDataShippingAddress:
      type: object
      properties:
        city:
          type: string
        name:
          type: string
        phone:
          type: string
        state:
          type: string
        country:
          type: string
        post_code:
          type: string
        address_one:
          type: string
        country_code:
          type: string
      required:
        - city
        - name
        - phone
        - state
        - country
        - post_code
        - address_one
        - country_code
      title: >-
        ProfilesVendorsPostResponsesContentApplicationJsonSchemaDataShippingAddress
    ProfilesVendorsPostResponsesContentApplicationJsonSchemaData:
      type: object
      properties:
        id:
          type: string
          format: uuid
        type:
          type: string
        email:
          type: string
          format: email
        phone:
          type: string
        accounts:
          type: array
          items:
            $ref: >-
              #/components/schemas/ProfilesVendorsPostResponsesContentApplicationJsonSchemaDataAccountsItems
        last_name:
          type: string
        contact_id:
          type: string
          format: uuid
        created_at:
          type: string
          format: date-time
        first_name:
          type: string
        project_id:
          type: string
        company_name:
          type: string
        display_name:
          type: string
        billing_address:
          $ref: >-
            #/components/schemas/ProfilesVendorsPostResponsesContentApplicationJsonSchemaDataBillingAddress
        shipping_address:
          $ref: >-
            #/components/schemas/ProfilesVendorsPostResponsesContentApplicationJsonSchemaDataShippingAddress
      required:
        - id
        - type
        - email
        - phone
        - accounts
        - last_name
        - contact_id
        - created_at
        - first_name
        - project_id
        - company_name
        - display_name
        - billing_address
        - shipping_address
      title: ProfilesVendorsPostResponsesContentApplicationJsonSchemaData
    Profiles_Vendors_Create Vendor_Response_201:
      type: object
      properties:
        data:
          $ref: >-
            #/components/schemas/ProfilesVendorsPostResponsesContentApplicationJsonSchemaData
        status:
          type: boolean
        message:
          type: string
      required:
        - data
        - status
        - message
      title: Profiles_Vendors_Create Vendor_Response_201
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    identityAuth:
      type: apiKey
      in: header
      name: identity
      description: The identity for the active project.

```

## Examples

### Profiles_Vendors_Create Vendor_example



**Request**

```json
undefined
```

**Response**

```json
{
  "data": {
    "id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
    "type": "BUSINESS",
    "email": "john@example.com",
    "phone": "+2348012345678",
    "accounts": [
      {
        "bank": "Spruce Bank",
        "code": "044",
        "vat_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
        "is_default": true,
        "account_name": "John Doe",
        "currency_code": "NGN",
        "account_number": "1234567890"
      }
    ],
    "last_name": "Doe",
    "contact_id": "64595845-34ec-482c-b0fe-ae617a0f8335",
    "created_at": "2026-06-18T10:00:00Z",
    "first_name": "John",
    "project_id": "spruce-demo",
    "company_name": "Acme Corp",
    "display_name": "Global Softworks",
    "billing_address": {
      "city": "Lagos",
      "name": "Office",
      "phone": "+2348012345678",
      "state": "Lagos",
      "country": "Nigeria",
      "post_code": "100001",
      "address_one": "12 Marina Road",
      "country_code": "NG"
    },
    "shipping_address": {
      "city": "Lagos",
      "name": "Office",
      "phone": "+2348012345678",
      "state": "Lagos",
      "country": "Nigeria",
      "post_code": "100001",
      "address_one": "12 Marina Road",
      "country_code": "NG"
    }
  },
  "status": true,
  "message": "Successfully created vendor"
}
```

**SDK Code**

```python Profiles_Vendors_Create Vendor_example
import requests

url = "https://api.papertracc.com/v1/profiles/vendors"

headers = {
    "Authorization": "Bearer <apiKey>",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers)

print(response.json())
```

```javascript Profiles_Vendors_Create Vendor_example
const url = 'https://api.papertracc.com/v1/profiles/vendors';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <apiKey>', 'Content-Type': 'application/json'},
  body: undefined
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Profiles_Vendors_Create Vendor_example
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.papertracc.com/v1/profiles/vendors"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <apiKey>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Profiles_Vendors_Create Vendor_example
require 'uri'
require 'net/http'

url = URI("https://api.papertracc.com/v1/profiles/vendors")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <apiKey>'
request["Content-Type"] = 'application/json'

response = http.request(request)
puts response.read_body
```

```java Profiles_Vendors_Create Vendor_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.papertracc.com/v1/profiles/vendors")
  .header("Authorization", "Bearer <apiKey>")
  .header("Content-Type", "application/json")
  .asString();
```

```php Profiles_Vendors_Create Vendor_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.papertracc.com/v1/profiles/vendors', [
  'headers' => [
    'Authorization' => 'Bearer <apiKey>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp Profiles_Vendors_Create Vendor_example
using RestSharp;

var client = new RestClient("https://api.papertracc.com/v1/profiles/vendors");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <apiKey>");
request.AddHeader("Content-Type", "application/json");
IRestResponse response = client.Execute(request);
```

```swift Profiles_Vendors_Create Vendor_example
import Foundation

let headers = [
  "Authorization": "Bearer <apiKey>",
  "Content-Type": "application/json"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.papertracc.com/v1/profiles/vendors")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Create a business vendor



**Request**

```json
{
  "type": "BUSINESS",
  "email": "billing@globalsoft.dev",
  "phone": "+2348011112222",
  "company_name": "Global Softworks LLC",
  "display_name": "Global Softworks",
  "currency_code": "NGN",
  "billing_address": {
    "city": "Lagos",
    "name": "Office",
    "phone": "+2348012345678",
    "state": "Lagos",
    "country": "Nigeria",
    "post_code": "100001",
    "address_one": "12 Marina Road",
    "country_code": "NG"
  },
  "shipping_address": {
    "city": "Lagos",
    "name": "Warehouse",
    "phone": "+2348012345678",
    "state": "Lagos",
    "country": "Nigeria",
    "post_code": "100001",
    "address_one": "18 Warehouse Road",
    "country_code": "NG"
  }
}
```

**Response**

```json
{
  "data": {
    "id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51",
    "type": "BUSINESS",
    "email": "john@example.com",
    "phone": "+2348012345678",
    "accounts": [
      {
        "bank": "Spruce Bank",
        "code": "044",
        "vat_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1",
        "is_default": true,
        "account_name": "John Doe",
        "currency_code": "NGN",
        "account_number": "1234567890"
      }
    ],
    "last_name": "Doe",
    "contact_id": "64595845-34ec-482c-b0fe-ae617a0f8335",
    "created_at": "2026-06-18T10:00:00Z",
    "first_name": "John",
    "project_id": "spruce-demo",
    "company_name": "Acme Corp",
    "display_name": "Global Softworks",
    "billing_address": {
      "city": "Lagos",
      "name": "Office",
      "phone": "+2348012345678",
      "state": "Lagos",
      "country": "Nigeria",
      "post_code": "100001",
      "address_one": "12 Marina Road",
      "country_code": "NG"
    },
    "shipping_address": {
      "city": "Lagos",
      "name": "Office",
      "phone": "+2348012345678",
      "state": "Lagos",
      "country": "Nigeria",
      "post_code": "100001",
      "address_one": "12 Marina Road",
      "country_code": "NG"
    }
  },
  "status": true,
  "message": "Successfully created vendor"
}
```

**SDK Code**

```python Create a business vendor
import requests

url = "https://api.papertracc.com/v1/profiles/vendors"

payload = {
    "type": "BUSINESS",
    "email": "billing@globalsoft.dev",
    "phone": "+2348011112222",
    "company_name": "Global Softworks LLC",
    "display_name": "Global Softworks",
    "currency_code": "NGN",
    "billing_address": {
        "city": "Lagos",
        "name": "Office",
        "phone": "+2348012345678",
        "state": "Lagos",
        "country": "Nigeria",
        "post_code": "100001",
        "address_one": "12 Marina Road",
        "country_code": "NG"
    },
    "shipping_address": {
        "city": "Lagos",
        "name": "Warehouse",
        "phone": "+2348012345678",
        "state": "Lagos",
        "country": "Nigeria",
        "post_code": "100001",
        "address_one": "18 Warehouse Road",
        "country_code": "NG"
    }
}
headers = {
    "Authorization": "Bearer <apiKey>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript Create a business vendor
const url = 'https://api.papertracc.com/v1/profiles/vendors';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <apiKey>', 'Content-Type': 'application/json'},
  body: '{"type":"BUSINESS","email":"billing@globalsoft.dev","phone":"+2348011112222","company_name":"Global Softworks LLC","display_name":"Global Softworks","currency_code":"NGN","billing_address":{"city":"Lagos","name":"Office","phone":"+2348012345678","state":"Lagos","country":"Nigeria","post_code":"100001","address_one":"12 Marina Road","country_code":"NG"},"shipping_address":{"city":"Lagos","name":"Warehouse","phone":"+2348012345678","state":"Lagos","country":"Nigeria","post_code":"100001","address_one":"18 Warehouse Road","country_code":"NG"}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Create a business vendor
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.papertracc.com/v1/profiles/vendors"

	payload := strings.NewReader("{\n  \"type\": \"BUSINESS\",\n  \"email\": \"billing@globalsoft.dev\",\n  \"phone\": \"+2348011112222\",\n  \"company_name\": \"Global Softworks LLC\",\n  \"display_name\": \"Global Softworks\",\n  \"currency_code\": \"NGN\",\n  \"billing_address\": {\n    \"city\": \"Lagos\",\n    \"name\": \"Office\",\n    \"phone\": \"+2348012345678\",\n    \"state\": \"Lagos\",\n    \"country\": \"Nigeria\",\n    \"post_code\": \"100001\",\n    \"address_one\": \"12 Marina Road\",\n    \"country_code\": \"NG\"\n  },\n  \"shipping_address\": {\n    \"city\": \"Lagos\",\n    \"name\": \"Warehouse\",\n    \"phone\": \"+2348012345678\",\n    \"state\": \"Lagos\",\n    \"country\": \"Nigeria\",\n    \"post_code\": \"100001\",\n    \"address_one\": \"18 Warehouse Road\",\n    \"country_code\": \"NG\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <apiKey>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Create a business vendor
require 'uri'
require 'net/http'

url = URI("https://api.papertracc.com/v1/profiles/vendors")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <apiKey>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"BUSINESS\",\n  \"email\": \"billing@globalsoft.dev\",\n  \"phone\": \"+2348011112222\",\n  \"company_name\": \"Global Softworks LLC\",\n  \"display_name\": \"Global Softworks\",\n  \"currency_code\": \"NGN\",\n  \"billing_address\": {\n    \"city\": \"Lagos\",\n    \"name\": \"Office\",\n    \"phone\": \"+2348012345678\",\n    \"state\": \"Lagos\",\n    \"country\": \"Nigeria\",\n    \"post_code\": \"100001\",\n    \"address_one\": \"12 Marina Road\",\n    \"country_code\": \"NG\"\n  },\n  \"shipping_address\": {\n    \"city\": \"Lagos\",\n    \"name\": \"Warehouse\",\n    \"phone\": \"+2348012345678\",\n    \"state\": \"Lagos\",\n    \"country\": \"Nigeria\",\n    \"post_code\": \"100001\",\n    \"address_one\": \"18 Warehouse Road\",\n    \"country_code\": \"NG\"\n  }\n}"

response = http.request(request)
puts response.read_body
```

```java Create a business vendor
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.papertracc.com/v1/profiles/vendors")
  .header("Authorization", "Bearer <apiKey>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"BUSINESS\",\n  \"email\": \"billing@globalsoft.dev\",\n  \"phone\": \"+2348011112222\",\n  \"company_name\": \"Global Softworks LLC\",\n  \"display_name\": \"Global Softworks\",\n  \"currency_code\": \"NGN\",\n  \"billing_address\": {\n    \"city\": \"Lagos\",\n    \"name\": \"Office\",\n    \"phone\": \"+2348012345678\",\n    \"state\": \"Lagos\",\n    \"country\": \"Nigeria\",\n    \"post_code\": \"100001\",\n    \"address_one\": \"12 Marina Road\",\n    \"country_code\": \"NG\"\n  },\n  \"shipping_address\": {\n    \"city\": \"Lagos\",\n    \"name\": \"Warehouse\",\n    \"phone\": \"+2348012345678\",\n    \"state\": \"Lagos\",\n    \"country\": \"Nigeria\",\n    \"post_code\": \"100001\",\n    \"address_one\": \"18 Warehouse Road\",\n    \"country_code\": \"NG\"\n  }\n}")
  .asString();
```

```php Create a business vendor
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.papertracc.com/v1/profiles/vendors', [
  'body' => '{
  "type": "BUSINESS",
  "email": "billing@globalsoft.dev",
  "phone": "+2348011112222",
  "company_name": "Global Softworks LLC",
  "display_name": "Global Softworks",
  "currency_code": "NGN",
  "billing_address": {
    "city": "Lagos",
    "name": "Office",
    "phone": "+2348012345678",
    "state": "Lagos",
    "country": "Nigeria",
    "post_code": "100001",
    "address_one": "12 Marina Road",
    "country_code": "NG"
  },
  "shipping_address": {
    "city": "Lagos",
    "name": "Warehouse",
    "phone": "+2348012345678",
    "state": "Lagos",
    "country": "Nigeria",
    "post_code": "100001",
    "address_one": "18 Warehouse Road",
    "country_code": "NG"
  }
}',
  'headers' => [
    'Authorization' => 'Bearer <apiKey>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp Create a business vendor
using RestSharp;

var client = new RestClient("https://api.papertracc.com/v1/profiles/vendors");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <apiKey>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"type\": \"BUSINESS\",\n  \"email\": \"billing@globalsoft.dev\",\n  \"phone\": \"+2348011112222\",\n  \"company_name\": \"Global Softworks LLC\",\n  \"display_name\": \"Global Softworks\",\n  \"currency_code\": \"NGN\",\n  \"billing_address\": {\n    \"city\": \"Lagos\",\n    \"name\": \"Office\",\n    \"phone\": \"+2348012345678\",\n    \"state\": \"Lagos\",\n    \"country\": \"Nigeria\",\n    \"post_code\": \"100001\",\n    \"address_one\": \"12 Marina Road\",\n    \"country_code\": \"NG\"\n  },\n  \"shipping_address\": {\n    \"city\": \"Lagos\",\n    \"name\": \"Warehouse\",\n    \"phone\": \"+2348012345678\",\n    \"state\": \"Lagos\",\n    \"country\": \"Nigeria\",\n    \"post_code\": \"100001\",\n    \"address_one\": \"18 Warehouse Road\",\n    \"country_code\": \"NG\"\n  }\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Create a business vendor
import Foundation

let headers = [
  "Authorization": "Bearer <apiKey>",
  "Content-Type": "application/json"
]
let parameters = [
  "type": "BUSINESS",
  "email": "billing@globalsoft.dev",
  "phone": "+2348011112222",
  "company_name": "Global Softworks LLC",
  "display_name": "Global Softworks",
  "currency_code": "NGN",
  "billing_address": [
    "city": "Lagos",
    "name": "Office",
    "phone": "+2348012345678",
    "state": "Lagos",
    "country": "Nigeria",
    "post_code": "100001",
    "address_one": "12 Marina Road",
    "country_code": "NG"
  ],
  "shipping_address": [
    "city": "Lagos",
    "name": "Warehouse",
    "phone": "+2348012345678",
    "state": "Lagos",
    "country": "Nigeria",
    "post_code": "100001",
    "address_one": "18 Warehouse Road",
    "country_code": "NG"
  ]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.papertracc.com/v1/profiles/vendors")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```