Org Contacts

The Org Contacts API provides operations to manage the contact types of your Okta org.

List all Org Contact Types
OAuth 2.0: okta.orgs.read

Lists all Org Contact Types for your Okta org

Responses
200

Success

403

Forbidden

429

Too Many Requests

get/api/v1/org/contacts
Request samples
Response samples
application/json
[]

Retrieve the Contact Type User
OAuth 2.0: okta.orgs.read

Retrieves the ID and the User resource associated with the specified Contact Type

Request
path Parameters
contactType
required
string

Type of contact

Enum: "BILLING" "TECHNICAL"
Example: BILLING
Responses
200

Success

403

Forbidden

404

Not Found

429

Too Many Requests

get/api/v1/org/contacts/{contactType}
Request samples
Response samples
application/json
{}

Replace the Contact Type User
OAuth 2.0: okta.orgs.manage

Replaces the User associated with the specified Contact Type

Request
path Parameters
contactType
required
string

Type of contact

Enum: "BILLING" "TECHNICAL"
Example: BILLING
Request Body schema: application/json
required
userId
string

Contact user ID

Responses
200

Success

400

Bad Request

403

Forbidden

404

Not Found

429

Too Many Requests

put/api/v1/org/contacts/{contactType}
Request samples
application/json
{
  • "userId": "00ux3u0ujW1r5AfZC1d7"
}
Response samples
application/json
{}