Rockwell Automation Contacts API

The Contacts API is used to manage contact master data.

Operations 7

POST /mdm/v1/contacts Create Contact #
GET /mdm/v1/contacts List Contacts #
POST /mdm/v1/contacts/{id}/deactivate Deactivate Contact #
DELETE /mdm/v1/contacts/{id} Delete Contact #
GET /mdm/v1/contacts/{id} Get Contact #
PUT /mdm/v1/contacts/{id} Update Contact #
POST /mdm/v1/contacts/sync Sync Contacts #

Documentation

Specifications

Schemas & Data

Other Resources

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/rockwell-automation:rockwell-automation-contacts-api-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

rockwell-automation-contacts-api-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Plex (Rockwell Automation) Connect Contacts API
  version: '2026-10-20'
  description: Plex Smart Manufacturing Platform REST APIs, converted mechanically from the structured operation documents the Plex Developer Portal (developers.plex.com, a Rockwell Automation property) serves at /api/documentation/{api}/{operation}. No operations were authored by hand.
  x-generated-from: provider-documentation-json
  x-source: https://developers.plex.com/api/documentation/info
servers:
- url: https://connect.plex.com
  description: Production
- url: https://test.connect.plex.com
  description: Test (from https://developers.plex.com/api/sandbox/url)
security:
- PlexConnectApiKey: []
tags:
- name: Contacts API
  description: The Contacts API is used to manage contact master data.
paths:
  /mdm/v1/contacts:
    post:
      operationId: createContact
      summary: Create Contact
      tags:
      - Contacts API
      description: Create a new Contact.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateContactDTO'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactDTO'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationResponse'
      x-source: https://developers.plex.com/api/documentation/contacts-api/create-contact
    get:
      operationId: listContacts
      summary: List Contacts
      tags:
      - Contacts API
      description: List Contacts by query parameters.
      parameters:
      - name: id
        in: query
        required: false
        schema:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        description: A list of contact IDs.
      - name: customerId
        in: query
        required: false
        schema:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
      - name: firstName
        in: query
        required: false
        schema:
          type: string
          example: string
      - name: lastName
        in: query
        required: false
        schema:
          type: string
          example: string
      - name: companyName
        in: query
        required: false
        schema:
          type: string
          example: string
      - name: description
        in: query
        required: false
        schema:
          type: string
          example: string
      - name: supplierId
        in: query
        required: false
        schema:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
      - name: type
        in: query
        required: false
        schema:
          type: string
          example: string
        description: 'Setup table: Contact Type.'
      - name: associatedWithId
        in: query
        required: false
        schema:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        description: IAM Account Id
      responses:
        '200':
          description: The query executed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactDTO'
      x-source: https://developers.plex.com/api/documentation/contacts-api/list-contacts
  /mdm/v1/contacts/{id}/deactivate:
    post:
      operationId: deactivateContact
      summary: Deactivate Contact
      tags:
      - Contacts API
      description: Deactivate a Contact.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
      responses:
        '202':
          description: Accepted
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationResponse'
        '404':
          description: Not Found
      x-source: https://developers.plex.com/api/documentation/contacts-api/deactivate-contact
  /mdm/v1/contacts/{id}:
    delete:
      operationId: deleteContact
      summary: Delete Contact
      tags:
      - Contacts API
      description: Delete a Contact.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationResponse'
        '404':
          description: Not Found
      x-source: https://developers.plex.com/api/documentation/contacts-api/delete-contact
    get:
      operationId: getContact
      summary: Get Contact
      tags:
      - Contacts API
      description: Retrieve a Contact by Resource ID.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        description: Contact Resource ID
      responses:
        '200':
          description: The query executed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactDTO'
        '400':
          description: Bad Request
        '404':
          description: The contact does not exist.
      x-source: https://developers.plex.com/api/documentation/contacts-api/get-contact
    put:
      operationId: updateContact
      summary: Update Contact
      tags:
      - Contacts API
      description: Update a Contact.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateContactDTO'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactDTO'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationResponse'
        '404':
          description: Not Found
      x-source: https://developers.plex.com/api/documentation/contacts-api/update-contact
  /mdm/v1/contacts/sync:
    post:
      operationId: syncContacts
      summary: Sync Contacts
      tags:
      - Contacts API
      description: Sync a set of Contacts from another system. This operation creates Contacts that do not exist in Plex and updates existing Contacts.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SyncContactDTO'
      responses:
        '202':
          description: Accepted
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationResponse'
      x-source: https://developers.plex.com/api/documentation/contacts-api/sync-contacts
components:
  schemas:
    ContactDTO:
      type: object
      description: The all-inclusive domain model for a Contact.
      properties:
        id:
          type: string
          format: uuid
          description: A unique identifier for the Contact.
          example: 00000000-0000-0000-0000-000000000000
        customerId:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        firstName:
          type: string
          example: string
        lastName:
          type: string
          example: string
        supplierId:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        phone:
          type: string
          example: string
        fax:
          type: string
          example: string
        mobilePhone:
          type: string
          example: string
        title:
          type: string
          example: string
        note:
          type: string
          example: string
        email:
          type: string
          example: string
        companyName:
          type: string
          example: string
        officeAddress:
          type: string
          example: string
        homeAddress:
          type: string
          example: string
        private:
          type: integer
          format: int32
          example: 0
        description:
          type: string
          example: string
        birthDate:
          type: string
          format: date-time
          example: '2026-10-20T12:03:01Z'
        url:
          type: string
          example: string
        sortOrder:
          type: integer
          format: int32
          example: 0
        type:
          type: string
          description: 'Setup table: Contact Type.'
          example: string
        associatedWithId:
          type: string
          format: uuid
          description: IAM Account Id
          example: 00000000-0000-0000-0000-000000000000
        modifiedById:
          type: string
          format: uuid
          description: IAM Account Id
          example: 00000000-0000-0000-0000-000000000000
        modifiedDate:
          type: string
          format: date-time
          example: '2026-10-20T12:03:01Z'
        createdById:
          type: string
          format: uuid
          description: IAM Account Id
          example: 00000000-0000-0000-0000-000000000000
        createdDate:
          type: string
          format: date-time
          example: '2026-10-20T12:03:01Z'
    SyncContactDTO:
      type: object
      description: The full Contact resource structure.
      properties:
        id:
          type: string
          format: uuid
          description: A unique identifier for the Contact. This will be automatically generated if omitted from the request.
          example: 00000000-0000-0000-0000-000000000000
        customerId:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        firstName:
          type: string
          example: string
        lastName:
          type: string
          example: string
        supplierId:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        phone:
          type: string
          example: string
        fax:
          type: string
          example: string
        mobilePhone:
          type: string
          example: string
        title:
          type: string
          example: string
        note:
          type: string
          example: string
        email:
          type: string
          example: string
        companyName:
          type: string
          example: string
        officeAddress:
          type: string
          example: string
        homeAddress:
          type: string
          example: string
        private:
          type: integer
          format: int32
          example: 0
        description:
          type: string
          example: string
        birthDate:
          type: string
          format: date-time
          example: '2026-10-20T12:03:01Z'
        url:
          type: string
          example: string
        sortOrder:
          type: integer
          format: int32
          example: 0
        type:
          type: string
          description: 'Setup table: Contact Type.'
          example: string
        associatedWithId:
          type: string
          format: uuid
          description: IAM Account Id
          example: 00000000-0000-0000-0000-000000000000
    UpdateContactDTO:
      type: object
      description: The Contact model exposed for updating.
      properties:
        id:
          type: string
          format: uuid
          description: A unique identifier for the Contact.
          example: 00000000-0000-0000-0000-000000000000
        customerId:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        firstName:
          type: string
          example: string
        lastName:
          type: string
          example: string
        supplierId:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        phone:
          type: string
          example: string
        fax:
          type: string
          example: string
        mobilePhone:
          type: string
          example: string
        title:
          type: string
          example: string
        note:
          type: string
          example: string
        email:
          type: string
          example: string
        companyName:
          type: string
          example: string
        officeAddress:
          type: string
          example: string
        homeAddress:
          type: string
          example: string
        private:
          type: integer
          format: int32
          example: 0
        description:
          type: string
          example: string
        birthDate:
          type: string
          format: date-time
          example: '2026-10-20T12:03:01Z'
        url:
          type: string
          example: string
        sortOrder:
          type: integer
          format: int32
          example: 0
        type:
          type: string
          description: 'Setup Table: Contact Type.'
          example: string
        associatedWithId:
          type: string
          format: uuid
          description: IAM Account Id
          example: 00000000-0000-0000-0000-000000000000
    ValidationResponse:
      type: object
      properties:
        code:
          type: string
          example: string
        message:
          type: string
          example: string
        errors:
          type: array
          items:
            type: object
            properties: {}
    CreateContactDTO:
      type: object
      description: The Contact model exposed for adding.
      properties:
        id:
          type: string
          format: uuid
          description: A unique identifier for the Contact. This will be automatically generated if omitted from the request.
          example: 00000000-0000-0000-0000-000000000000
        customerId:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        firstName:
          type: string
          example: string
        lastName:
          type: string
          example: string
        supplierId:
          type: string
          format: uuid
          example: 00000000-0000-0000-0000-000000000000
        phone:
          type: string
          example: string
        fax:
          type: string
          example: string
        mobilePhone:
          type: string
          example: string
        title:
          type: string
          example: string
        note:
          type: string
          example: string
        email:
          type: string
          example: string
        companyName:
          type: string
          example: string
        officeAddress:
          type: string
          example: string
        homeAddress:
          type: string
          example: string
        private:
          type: integer
          format: int32
          example: 0
        description:
          type: string
          example: string
        birthDate:
          type: string
          format: date-time
          example: '2026-10-20T12:03:01Z'
        url:
          type: string
          example: string
        sortOrder:
          type: integer
          format: int32
          example: 0
        type:
          type: string
          description: 'Setup table: Contact Type.'
          example: string
        associatedWithId:
          type: string
          format: uuid
          description: IAM Account Id
          example: 00000000-0000-0000-0000-000000000000
  securitySchemes:
    PlexConnectApiKey:
      type: apiKey
      in: header
      name: X-Plex-Connect-Api-Key
      description: 'Subscription key (Consumer Key of an app created in the Plex Developer Portal). Source: https://developers.plex.com/getstarted'