---
title: "Create a new relationship type"
description: "POST /relationship_types — Creates a relationship type from a variants list: one variant name makes a symmetrical type (Partner/Partner), two make a directional one (Manager/Reports to)."
canonical_url: https://developer.onepagecrm.com/api/reference/relationship-types/post-relationship_types/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/relationship-types/post-relationship_types/
---

`POST /relationship_types`

Creates a relationship type from a variants list: one variant name makes a symmetrical type (Partner/Partner), two make a directional one (Manager/Reports to). Whether a type is symmetrical is derived from that count, not set directly. An account is limited to 50 types, and variant names to 35 characters.

Resource: [Relationship Types](https://developer.onepagecrm.com/api/reference/relationship-types/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl -X POST "https://app.onepagecrm.com/api/v3/relationship_types" \
  -u $user_id:$api_key \
  -H "Content-Type: application/json" \
  -d '{
    "variants": [
      {
        "name": "Partner"
      }
    ]
  }'
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `variants` | array<object> |  | The relationship variants. |

## Responses

### 201

Created

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "relationship_types": [
      {
        "relationship_type": {
          "id": "5aaa9b059007ba08c9ebaf58",
          "symmetrical": true,
          "relationship_variants": [
            {}
          ],
          "created_at": "2018-03-15T16:10:45Z",
          "modified_at": "2018-03-15T16:10:45Z"
        }
      }
    ]
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)