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

Operations 6

GET /contact_types List Contact Types #
POST /contact_types Create a Contact Type #
PATCH /contact_types/{id} Update a Contact Type #
DELETE /contact_types/{id} Delete a Contact Type #
PATCH /contact_types/{external_id}/external_id Update a Contact Type by External ID #
DELETE /contact_types/{external_id}/external_id Delete a Contact Type by External ID #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/scoutrfp:scoutrfp-contact-types-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

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 Specification

scoutrfp-contact-types-api-openapi.yml Raw ↑
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