# Creates a new referral connection request to another adviser using their referral code.

**POST /api/v1/referral-connections**

An email notification will be sent to the recipient with accept/deny links.


## Servers
- https://api.plannrcrm.com: https://api.plannrcrm.com ()


## Authentication methods
- Personal access token & O auth2


## Parameters
### Headers
- **X-PLANNR-ACCOUNT-UUID** (string)




### Body: application/json (object)

- **adviser_key** (string)
  The 8-character referral code of the adviser you want to connect with.


## Responses
### 200


#### Body: application/json (object)
- **uuid** (string)
  The UUID of the resource.
- **direction** (string)
  The direction of the connection relative to the current firm. Possible values: sent, received
- **status** (string)
  The status of the referral connection. Possible values: pending, accepted, denied, expired
- **sender_firm** (object)
  The firm that sent the referral connection request
- **recipient_firm** (object)
  The firm that received the referral connection request
- **sender_account** (object)
  The account that sent the referral connection request
- **recipient_account** (object)
  The account that received the referral connection request
- **created_at** (string)
  The timestamp of when the resource was created.
- **updated_at** (string)
  The timestamp of when the resource was updated.
- **expires_at** (string)
  The datetime when the referral connection request expires


[Powered by Bump.sh](https://bump.sh)