---
title: "Add Talent Referrals"
method: POST
path: "/v1/talent/{talentId}/talent-referrals"
tags: ["Talent"]
---

# Add Talent Referrals

`POST /v1/talent/{talentId}/talent-referrals`

Adds talent referrals by the specified talent and/or for the specified talent.

## Path parameters

- `talentId` string, required

## Headers

- `RequestId` string, uuid — The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.
- `FrontOfficeTenantId` integer
- `Tenant` string

## Request body

- TalentReferrals
  - `talentId` integer, required — The identifier for the talent.
  - `referredBy` ReferredBy[] — The list of referrals that referred the talent.
    - `referralId` integer — The identifier for the referral record.
    - `referredById` integer — The identifier for the person who made the referral, if they are a talent or contact in Bold. It is possible to add a ReferredBy referral by name only if ReferredById is 0 or is not passed in.
    - `referredByName` string — The name of the person who made the referral. It is possible to add a ReferredBy referral by name only if ReferredById is 0 or is not passed in.
    - `referredByEntityType` string — The entity type for the person who made the referral. When adding a ReferredBy referral, if the person is a talent or contact in Bold and a ReferredById is passed in, then the value must be 'Talent' or 'Contact'.
    - `referralDate` string, date-time — The date of the referral. When adding a referral, the date will default to the current date-time if not passed in. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.
  - `referrerOf` ReferrerOf[] — The list of referrals initiated by the talent.
    - `referralId` integer — The identifier for the referral record.
    - `referrerOfId` integer — The identifier for the talent or contact who was referred. It is required when adding a ReferrerOf referral.
    - `referrerOfName` string — The name of the person who was referred.
    - `referrerOfEntityType` string — The entity type for the person who was referred. When adding a ReferrerOf referral the value must be 'Talent' or 'Contact'.
    - `referralDate` string, date-time — The date of the referral. When adding a referral, the date will default to the current date-time if not passed in. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.

## Response `201`

The response containing the added talent referrals.

- TalentReferralsResponse
  - `referrals` TalentReferrals
    - `talentId` integer, required — The identifier for the talent.
    - `referredBy` ReferredBy[] — The list of referrals that referred the talent.
      - `referralId` integer — The identifier for the referral record.
      - `referredById` integer — The identifier for the person who made the referral, if they are a talent or contact in Bold. It is possible to add a ReferredBy referral by name only if ReferredById is 0 or is not passed in.
      - `referredByName` string — The name of the person who made the referral. It is possible to add a ReferredBy referral by name only if ReferredById is 0 or is not passed in.
      - `referredByEntityType` string — The entity type for the person who made the referral. When adding a ReferredBy referral, if the person is a talent or contact in Bold and a ReferredById is passed in, then the value must be 'Talent' or 'Contact'.
      - `referralDate` string, date-time — The date of the referral. When adding a referral, the date will default to the current date-time if not passed in. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.
    - `referrerOf` ReferrerOf[] — The list of referrals initiated by the talent.
      - `referralId` integer — The identifier for the referral record.
      - `referrerOfId` integer — The identifier for the talent or contact who was referred. It is required when adding a ReferrerOf referral.
      - `referrerOfName` string — The name of the person who was referred.
      - `referrerOfEntityType` string — The entity type for the person who was referred. When adding a ReferrerOf referral the value must be 'Talent' or 'Contact'.
      - `referralDate` string, date-time — The date of the referral. When adding a referral, the date will default to the current date-time if not passed in. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.
  - `errors` string[] — A list of error messages after an attempt to add one or more talent referrals.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Access Denied
- `404` — Not found
- `405` — Unsupported method
- `406` — Unsupported format(s) indicated by Accept header
- `415` — Unsupported format(s) indicated by the Content-Type header
- `429` — Too many requests
- `500` — An unexpected error occurred
- `502` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.net/avionte/apis/aviont-partner-authorization-api.md) · [All operations](https://skmtc.net/avionte/apis/aviont-partner-authorization-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avionte/aviont-partner-authorization-api/revisions/846b33e4e71b/schema)