Save Contacts | Customer Support College Pipe

PUT https://api.collegepipe.com/v1/athletes/contacts

Beta — This endpoint is not yet live but will be available soon.

Authentication

You need to authenticate first to replace contacts.

Overview

Replaces all contacts for a given athlete in one call. Existing contacts are deleted first, then the new list is saved.

Maximum 5 contacts per athlete
The athlete must belong to your agency
This endpoint uses JSON (application/json)

⚠️ Contacts are replaced, not merged. Always send the full desired list — any contact not included will be deleted.

Example

Request

PUT https://api.collegepipe.com/v1/athletes/contacts
Authorization: Bearer <token>
Content-Type: application/json

Request Body

Field	Type	Required	Description
athleteEmail	String	✅	Email of the athlete whose contacts are being replaced
contacts	Array	✅	List of contact objects (max 5)

Contact object

Field	Type	Required	Description
type	String	✅	`PARENT`, `CLUB_COACH`, `HIGH_SCHOOL_COACH`, or `OTHER_COACH`
firstName	String	No	—
lastName	String	No	—
email	String	No	—
phone	String	No	—
info	String	No	Free-text notes (e.g. relationship, availability)

Request Example

{
	"athleteEmail": "jane.doe@example.com",
	"contacts": [
		{
			"type": "PARENT",
			"firstName": "John",
			"lastName": "Doe",
			"email": "john.doe@example.com",
			"phone": "+1-555-0100"
		},
		{
			"type": "CLUB_COACH",
			"firstName": "Maria",
			"lastName": "Garcia",
			"email": "m.garcia@club.com",
			"info": "Head coach, available on weekdays"
		}
	]
}

Response

Returns the saved contact list.

Response Example

[
	{
		"type": "PARENT",
		"firstName": "John",
		"lastName": "Doe",
		"email": "john.doe@example.com",
		"phone": "+1-555-0100",
		"info": null
	},
	{
		"type": "CLUB_COACH",
		"firstName": "Maria",
		"lastName": "Garcia",
		"email": "m.garcia@club.com",
		"phone": null,
		"info": "Head coach, available on weekdays"
	}
]

On error:

{
	"status": "error",
	"message": "Athlete not found: jane.doe@example.com"
}