Create Athlete

Create Athlete in Organization

curl --request POST \
  --url https://api.uplift.ai/v1/athletes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "date_of_birth": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "height": 123,
  "weight": 123,
  "positions": [
    "<string>"
  ],
  "custom_attributes": {}
}
'

import requests

url = "https://api.uplift.ai/v1/athletes"

payload = {
    "first_name": "<string>",
    "last_name": "<string>",
    "date_of_birth": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "height": 123,
    "weight": 123,
    "positions": ["<string>"],
    "custom_attributes": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    first_name: '<string>',
    last_name: '<string>',
    date_of_birth: '<string>',
    email: '<string>',
    phone: '<string>',
    height: 123,
    weight: 123,
    positions: ['<string>'],
    custom_attributes: {}
  })
};

fetch('https://api.uplift.ai/v1/athletes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.uplift.ai/v1/athletes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'first_name' => '<string>',
    'last_name' => '<string>',
    'date_of_birth' => '<string>',
    'email' => '<string>',
    'phone' => '<string>',
    'height' => 123,
    'weight' => 123,
    'positions' => [
        '<string>'
    ],
    'custom_attributes' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.uplift.ai/v1/athletes"

	payload := strings.NewReader("{\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"date_of_birth\": \"<string>\",\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"height\": 123,\n  \"weight\": 123,\n  \"positions\": [\n    \"<string>\"\n  ],\n  \"custom_attributes\": {}\n}")

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

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

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.uplift.ai/v1/athletes")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"date_of_birth\": \"<string>\",\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"height\": 123,\n  \"weight\": 123,\n  \"positions\": [\n    \"<string>\"\n  ],\n  \"custom_attributes\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.uplift.ai/v1/athletes")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"date_of_birth\": \"<string>\",\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"height\": 123,\n  \"weight\": 123,\n  \"positions\": [\n    \"<string>\"\n  ],\n  \"custom_attributes\": {}\n}"

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

{
  "athlete": {
    "id": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "date_of_birth": "2023-11-07T05:31:56Z",
    "email": "<string>",
    "phone": "<string>",
    "positions": [
      "<string>"
    ],
    "height": 123,
    "weight": 123,
    "custom_attributes": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "BadRequest",
  "message": "The request parameters are invalid. Please review the request and try again."
}

{
  "error": "Unauthorized",
  "message": "Bearer token is missing or invalid."
}

{
  "error": "Forbidden",
  "message": "You do not have permission to access this resource."
}

{
  "error": "TooManyRequests",
  "message": "The rate limit has been exceeded. Please wait and try again later."
}

{
  "error": "InternalServerError",
  "message": "An unexpected error occurred on the server. Please try again later."
}

POST

athletes

Create Athlete in Organization

curl --request POST \
  --url https://api.uplift.ai/v1/athletes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "<string>",
  "last_name": "<string>",
  "date_of_birth": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "height": 123,
  "weight": 123,
  "positions": [
    "<string>"
  ],
  "custom_attributes": {}
}
'

import requests

url = "https://api.uplift.ai/v1/athletes"

payload = {
    "first_name": "<string>",
    "last_name": "<string>",
    "date_of_birth": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "height": 123,
    "weight": 123,
    "positions": ["<string>"],
    "custom_attributes": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    first_name: '<string>',
    last_name: '<string>',
    date_of_birth: '<string>',
    email: '<string>',
    phone: '<string>',
    height: 123,
    weight: 123,
    positions: ['<string>'],
    custom_attributes: {}
  })
};

fetch('https://api.uplift.ai/v1/athletes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.uplift.ai/v1/athletes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'first_name' => '<string>',
    'last_name' => '<string>',
    'date_of_birth' => '<string>',
    'email' => '<string>',
    'phone' => '<string>',
    'height' => 123,
    'weight' => 123,
    'positions' => [
        '<string>'
    ],
    'custom_attributes' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.uplift.ai/v1/athletes"

	payload := strings.NewReader("{\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"date_of_birth\": \"<string>\",\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"height\": 123,\n  \"weight\": 123,\n  \"positions\": [\n    \"<string>\"\n  ],\n  \"custom_attributes\": {}\n}")

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

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

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.uplift.ai/v1/athletes")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"date_of_birth\": \"<string>\",\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"height\": 123,\n  \"weight\": 123,\n  \"positions\": [\n    \"<string>\"\n  ],\n  \"custom_attributes\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.uplift.ai/v1/athletes")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"first_name\": \"<string>\",\n  \"last_name\": \"<string>\",\n  \"date_of_birth\": \"<string>\",\n  \"email\": \"<string>\",\n  \"phone\": \"<string>\",\n  \"height\": 123,\n  \"weight\": 123,\n  \"positions\": [\n    \"<string>\"\n  ],\n  \"custom_attributes\": {}\n}"

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

{
  "athlete": {
    "id": "<string>",
    "first_name": "<string>",
    "last_name": "<string>",
    "date_of_birth": "2023-11-07T05:31:56Z",
    "email": "<string>",
    "phone": "<string>",
    "positions": [
      "<string>"
    ],
    "height": 123,
    "weight": 123,
    "custom_attributes": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "BadRequest",
  "message": "The request parameters are invalid. Please review the request and try again."
}

{
  "error": "Unauthorized",
  "message": "Bearer token is missing or invalid."
}

{
  "error": "Forbidden",
  "message": "You do not have permission to access this resource."
}

{
  "error": "TooManyRequests",
  "message": "The rate limit has been exceeded. Please wait and try again later."
}

{
  "error": "InternalServerError",
  "message": "An unexpected error occurred on the server. Please try again later."
}

Custom Attributes

custom_attributes (object)
- A set of user-defined key-value pairs for additional attributes.
- Key Format Rules:
  - Must contain only alphanumeric characters, underscores (_), or dashes (-).
  - Must start with a letter or underscore.
  - Must avoid spaces and special characters (e.g., @, #, $, etc.).
  - Reserved keywords (e.g., first_name, last_name, date_of_birth, email, height, weight, and DOB) cannot be used as keys.
- Value:
  - Must be a string.

Example Request Body

{
  "first_name": "John",
  "last_name": "Doe",
  "date_of_birth": "1990-01-01",
  "email": "john.doe@example.com",
  "height": 70,
  "weight": 180,
  "custom_attributes": {
    "team": "Team A",
    "position": "left fielder"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

first_name

string

required

The first name of the athlete.

Note: This is the minimum required field.

last_name

string

The last name of the athlete.

date_of_birth

string

The date of birth of the athlete, formatted as YYYY-MM-DD

string

The athlete's email address.

phone

string

The athlete's phone number.

gender

enum<string>

The athlete's gender. Allowed values: male, female, non-binary, prefer_not_to_say.

Available options:

male,

female,

non-binary,

prefer_not_to_say

height

integer

The height of the athlete, in inches.

weight

integer

The weight of the athlete, in pounds (lbs).

dominant_arm

enum<string>

Dominant arm. Allowed values: left, right, both.

Available options:

left,

right,

both

dominant_leg

enum<string>

Dominant leg. Allowed values: left, right, both.

Available options:

left,

right,

both

activity

enum<string>

Primary sport or activity. Allowed values: baseball, softball, tennis, basketball, golf.

Available options:

baseball,

softball,

tennis,

basketball,

golf

positions

string[]

Positions for the athlete's activity. Requires activity to be set. baseball/softball: pitcher, catcher, first_base, second_base, third_base, shortstop, left_field, center_field, right_field, designated_hitter. basketball: point_guard, shooting_guard, small_forward, power_forward, center.

competition_level

enum<string>

Competition level. Allowed values: youth, high_school, college, professional.

Available options:

youth,

high_school,

college,

professional

custom_attributes

object

A set of custom key-value attributes. Keys must be strings, and values must also be strings.

Show child attributes

Response

Athlete created successfully.

athlete

object

Show child attributes

API Documentation

Data Export

Captures

Athletes

Create Athlete

Custom Attributes

Example Request Body

Authorizations

Body

Response

​Custom Attributes

​Example Request Body

Authorizations

Body

Response

Custom Attributes

Example Request Body