Scout RFP (Workday Strategic Sourcing) Contact Types API
Use the contact types API to create, update, and query the contact types in Workday Strategic Sourcing. ## ContactType Object
Use the contact types API to create, update, and query the contact types in Workday Strategic Sourcing. ## ContactType Object
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/scoutrfp:scoutrfp-contact-types-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Workday Strategic Sourcing Supplier Contact Types API
version: '1.0'
description: ''
servers:
- url: https://api.us.workdayspend.com/services/suppliers/v1
description: Production Server
- url: https://api.sandbox.us.workdayspend.com/services/suppliers/v1
description: Sandbox Server
security:
- api_key: []
user_token: []
user_email: []
tags:
- name: Contact Types
x-displayName: Contact Types
description: 'Use the contact types API to create, update, and query the contact types in Workday Strategic Sourcing.
## ContactType Object'
paths:
/contact_types:
get:
tags:
- Contact Types
description: Returns a list of contact types.
operationId: ListContactTypes
summary: List Contact Types
responses:
'200':
description: OK
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/ContactType'
examples:
success:
$ref: '#/components/examples/index_response-3'
'401':
description: Unauthorized
x-codeSamples:
- label: Curl
source: "curl -H \"X-Api-Key: ${COMPANY_KEY}\" \\\n -H \"X-User-Token: ${USER_TOKEN}\" \\\n -H \"X-User-Email: ${USER_EMAIL}\" \\\n -H \"Content-Type: application/vnd.api+json\" \\\n \"https://api.us.workdayspend.com/services/suppliers/v1/contact_types\"\n"
x-operation-id-source: normalized
x-operation-id-original: List Contact Types
post:
tags:
- Contact Types
description: Create a contact type with given parameters.
operationId: CreateAContactType
summary: Create a Contact Type
requestBody:
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/ContactTypeCreate'
examples:
success:
$ref: '#/components/examples/create_request-2'
responses:
'201':
description: OK
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/ContactType'
examples:
success:
$ref: '#/components/examples/create_response-3'
'401':
description: Unauthorized
x-codeSamples:
- label: Curl
source: "curl -H \"X-Api-Key: ${COMPANY_KEY}\" \\\n -H \"X-User-Token: ${USER_TOKEN}\" \\\n -H \"X-User-Email: ${USER_EMAIL}\" \\\n -H \"Content-Type: application/vnd.api+json\" \\\n -X POST \\\n -d '{\"data\":{\"type\":\"contact_types\",\"attributes\":{\"name\":\"Contact Type\"}}' \\\n \"https://api.us.workdayspend.com/services/suppliers/v1/contact_types\"\n"
x-operation-id-source: normalized
x-operation-id-original: Create a Contact Type
/contact_types/{id}:
patch:
tags:
- Contact Types
description: 'Updates the details of an existing contact type. You need to supply the unique
identifier that was returned upon contact type creation.
Please note, that request body must include an `id` attribute with the value of your contact type
unique identifier (the same one you passed in the URL).'
operationId: UpdateAContactType
summary: Update a Contact Type
parameters:
- name: id
in: path
description: Unique contact type identifier.
required: true
schema:
type: integer
example: 1
requestBody:
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/ContactTypeUpdate'
examples:
success:
$ref: '#/components/examples/update_request-3'
responses:
'200':
description: OK
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/ContactType'
examples:
success:
$ref: '#/components/examples/update_response-3'
'401':
description: Unauthorized
'404':
description: Not Found
'409':
description: Conflict
content:
application/vnd.api+json:
schema:
$ref: '#/components/schemas/Errors'
examples:
invalid_type:
summary: Missing or invalid 'type' specified, expected 'contact_types'
description: 'Returns error due to invalid `type` parameter.
'
value:
errors:
- detail: Missing or invalid 'type' specified, expected 'contact_types'
x-codeSamples:
- label: Curl
source: "curl -H \"X-Api-Key: ${COMPANY_KEY}\" \\\n -H \"X-User-Token: ${USER_TOKEN}\" \\\n -H \"X-User-Email: ${USER_EMAIL}\" \\\n -H \"Content-Type: application/vnd.api+json\" \\\n -X PATCH \\\n -d '{\"data\":{\"type\":\"contact_types\",\"id\":\"2\",\"attributes\":{\"name\":\"Updated Field Contact Type\"}}}' \\\n \"https://api.us.workdayspend.com/services/suppliers/v1/contact_types/2\"\n"
x-operation-id-source: normalized
x-operation-id-original: Update a Contact Type
delete:
tags:
- Contact Types
description: 'Deletes a contact type. You need to supply the unique contact type
identifier that was returned upon contact type creation.'
operationId: DeleteAContactType
summary: Delete a Contact Type
parameters:
- name: id
in: path
description: Unique contact type identifier.
required: true
schema:
type: integer
example: 1
responses:
'204':
description: OK
'401':
description: Unauthorized
'404':
description: Not Found
x-codeSamples:
- label: Curl
source: "curl -H \"X-Api-Key: ${COMPANY_KEY}\" \\\n -H \"X-User-Token: ${USER_TOKEN}\" \\\n -H \"X-User-Email: ${USER_EMAIL}\" \\\n -H \"Content-Type: application/vnd.api+json\" \\\n -X DELETE \\\n \"https://api.us.workdayspend.com/services/suppliers/v1/contact_types/1\"\n"
x-operation-id-source: normalized
x-operation-id-original: Delete a Contact Type
/contact_types/{external_id}/external_id:
patch:
tags:
- Contact Types
description: 'Updates the details of an existing contact type. You need to supply the unique
external identifier assigned to the contact type on creation.
Please note, that request body must include an `id` attribute with the value of your contact type
unique identifier (the same one you passed in the URL).'
operationId: UpdateAContactTypeByExternalID
summary: Update a Contact Type by External ID
parameters:
- name: external_id
in: path
description: Unique contact type external identifier.
required: true
schema:
type: string
example: CTYPE
requestBody:
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/ContactTypeUpdate'
examples:
success:
$ref: '#/components/examples/external_update_request-3'
responses:
'200':
description: OK
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/ContactType'
examples:
success:
$ref: '#/components/examples/external_update_response-3'
'401':
description: Unauthorized
'404':
description: Not Found
x-codeSamples:
- label: Curl
source: "curl -H \"X-Api-Key: ${COMPANY_KEY}\" \\\n -H \"X-User-Token: ${USER_TOKEN}\" \\\n -H \"X-User-Email: ${USER_EMAIL}\" \\\n -H \"Content-Type: application/vnd.api+json\" \\\n -X PATCH \\\n -d '{\"data\":{\"type\":\"contact_types\",\"id\":\"CTYPE\",\"attributes\":{\"name\":\"Updated Field Contact Type\"}}}' \\\n \"https://api.us.workdayspend.com/services/suppliers/v1/contact_types/CTYPE/external_id\"\n"
x-operation-id-source: normalized
x-operation-id-original: Update a Contact Type by External ID
delete:
tags:
- Contact Types
description: 'Deletes a contact type. You need to supply the unique contact type
external identifier assigned to the contact type on creation.'
operationId: DeleteAContactTypeByExternalID
summary: Delete a Contact Type by External ID
parameters:
- name: external_id
in: path
description: Unique contact type external identifier.
required: true
schema:
type: string
example: CTYPE
responses:
'204':
description: OK
'401':
description: Unauthorized
'404':
description: Not Found
x-codeSamples:
- label: Curl
source: "curl -H \"X-Api-Key: ${COMPANY_KEY}\" \\\n -H \"X-User-Token: ${USER_TOKEN}\" \\\n -H \"X-User-Email: ${USER_EMAIL}\" \\\n -H \"Content-Type: application/vnd.api+json\" \\\n -X DELETE \\\n \"https://api.us.workdayspend.com/services/suppliers/v1/contact_types/CTYPE/external_id\"\n"
x-operation-id-source: normalized
x-operation-id-original: Delete a Contact Type by External ID
components:
examples:
update_request-3:
value:
data:
type: contact_types
id: '1'
attributes:
name: Contact Type Updated
external_id: CTYPE-UPD
update_response-3:
value:
data:
id: '1'
type: contact_types
attributes:
name: Contact Type Updated
external_id: CTYPE-UPD
links:
self: https://api.us.workdayspend.com/services/suppliers/v1/contact_types/1
external_update_request-3:
value:
data:
type: contact_types
id: CTYPE
attributes:
name: Contact Type Updated
create_request-2:
value:
data:
type: contact_types
attributes:
name: 'Contact Type #1'
external_id: CTYPE-1
index_response-3:
value:
data:
- id: '1'
type: contact_types
attributes:
name: 'Contact Type #1'
external_id: CTYPE-1
links:
self: https://api.us.workdayspend.com/services/suppliers/v1/contact_types/1
- id: '2'
type: contact_types
attributes:
name: 'Contact Type #2'
external_id: CTYPE-2
links:
self: https://api.us.workdayspend.com/services/suppliers/v1/contact_types/2
links:
self: https://api.us.workdayspend.com/services/suppliers/v1/contact_types
external_update_response-3:
value:
data:
id: '1'
type: contact_types
attributes:
name: Contact Type Updated
external_id: CTYPE
links:
self: https://api.us.workdayspend.com/services/suppliers/v1/contact_types/1
create_response-3:
value:
data:
id: '1'
type: contact_types
attributes:
name: 'Contact Type #1'
external_id: CTYPE-1
links:
self: https://api.us.workdayspend.com/services/suppliers/v1/contact_types/1
schemas:
ContactTypeBase:
title: Field
type: object
required:
- type
- id
properties:
type:
$ref: '#/components/schemas/ContactTypeType'
id:
$ref: '#/components/schemas/ContactTypeId'
ContactTypeUpdate:
type: object
required:
- type
- id
properties:
type:
$ref: '#/components/schemas/ContactTypeType'
id:
$ref: '#/components/schemas/ContactTypeId'
attributes:
$ref: '#/components/schemas/ContactTypeAttributes'
ContactTypeId:
type: integer
description: Contact type identifier string.
example: 1
ContactType:
allOf:
- $ref: '#/components/schemas/ContactTypeBase'
- type: object
properties:
attributes:
$ref: '#/components/schemas/ContactTypeAttributes'
ContactTypeCreate:
type: object
required:
- type
properties:
type:
$ref: '#/components/schemas/ContactTypeType'
attributes:
allOf:
- $ref: '#/components/schemas/ContactTypeAttributes'
- type: object
required:
- name
Error:
type: object
properties:
detail:
type: string
description: A human-readable explanation specific to this occurrence of the problem.
ContactTypeType:
type: string
description: Object type, should always be `contact_types`.
example: contact_types
Errors:
type: object
properties:
errors:
type: array
items:
$ref: '#/components/schemas/Error'
ContactTypeAttributes:
type: object
description: Contact type attributes.
required:
- name
properties:
name:
type: string
maxLength: 255
description: Contact type name.
example: Financials
external_id:
type: string
maxLength: 255
description: Contact type external identifier.
securitySchemes:
api_key:
type: apiKey
name: X-Api-Key
in: header
description: Company API key.
user_token:
type: apiKey
name: X-User-Token
in: header
description: User token.
user_email:
type: apiKey
name: X-User-Email
in: header
description: User email.
x-tagGroups:
- name: Getting Started
tags:
- support
- servers
- api_specification
- date_and_time_fields
- authentication
- rate_limiting
- external_ids
- pagination
- filters
- name: Suppliers
tags:
- supplier_companies
- supplier_contacts
- supplier_classifications
- supplier_company_segmentations
- supplier_company_risks
- supplier_company_segmentation_statuses
- supplier_categories
- supplier_groups
- contact_types
- communication_usage_behaviors
- phone_device_types