Act! CRM

Act! CRM Secondary Contacts API

The SecondaryContacts API from Act! CRM — 3 operation(s) for secondarycontacts.

GitHub OpenAPI
Business capability
Customer Data Management BC-420.10

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/contacts/{contactId}/secondary-contacts/{id} Get a secondary contact · Get a specific secondary contact #
Ask an LLM
“How do I look up one secondary contact under a primary contact?”
“Can I get a secondary contact's phone numbers in international format?”
Tell an agent
Fetch secondary contact {id} under contact {contactId}.
Show secondary contact {id} of contact {contactId} with phones in {phoneFormat} format.
PUT /api/contacts/{contactId}/secondary-contacts/{id} Replace a secondary contact · Update an already existing secondary contact #
Ask an LLM
“How do I overwrite an entire secondary contact record?”
“Can I resend a full secondary contact to change its job title and email?”
Tell an agent
Replace secondary contact {id} under {contactId} with name {fullName} and email {emailAddress}.
Do a full update of secondary contact {id} on {contactId} with job title {jobTitle}.
DELETE /api/contacts/{contactId}/secondary-contacts/{id} Delete a secondary contact · Delete an existing secondary contact #
Ask an LLM
“How do I remove an assistant or secondary contact from a primary contact?”
“Does deleting a secondary contact affect the primary contact?”
Tell an agent destructive · confirm first
Delete secondary contact {id} from contact {contactId}.
Remove the secondary person {id} listed under {contactId}.
PATCH /api/contacts/{contactId}/secondary-contacts/{id} Change a few fields on a secondary contact · Update (partially) an already existing secondary contact #
Ask an LLM
“Can I update only a secondary contact's mobile number?”
“How do I change just the email on a secondary contact?”
Tell an agent
Set the mobile phone of secondary contact {id} under {contactId} to {mobilePhone}.
Patch secondary contact {id} on {contactId} so the email is {emailAddress}.
GET /api/contacts/{contactId}/secondary-contacts List a contact's secondary contacts · Get all secondary contacts matching an (optional) OData query #
Ask an LLM
“Who are the secondary contacts listed under a primary contact?”
“Can I filter a contact's secondary contacts with OData?”
Tell an agent
List the secondary contacts of contact {contactId}.
Show everyone filed as a secondary contact under {contactId}.
POST /api/contacts/{contactId}/secondary-contacts Add a secondary contact · Create a new secondary contact #
Ask an LLM
“How do I add an assistant as a secondary contact on someone's record?”
“What details can I store on a new secondary contact?”
Tell an agent
Add {firstName} {lastName} as a secondary contact under {contactId}.
Create a secondary contact on {contactId} with email {emailAddress} and title {jobTitle}.
PUT /api/contacts/{contactId}/secondary-contacts/{id}/promote Promote a secondary contact to primary · Promote secondary contact to primary #
Ask an LLM
“How do I turn a secondary contact into a full primary contact?”
“Can I promote someone filed under another contact to their own record?”
Tell an agent
Promote secondary contact {id} under {contactId} to a primary contact.
Make secondary contact {id} of {contactId} a standalone contact.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/act/refs/heads/main/openapi/act-secondarycontacts-api-openapi.yml

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/act:act-secondarycontacts-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

act-secondarycontacts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: v1
  title: act.web.api Secondary Contacts API
servers:
- url: https://apimta.act.com/act.web.api
tags:
- name: SecondaryContacts
paths:
  /api/contacts/{contactId}/secondary-contacts/{id}:
    get:
      tags:
      - SecondaryContacts
      summary: Get a specific secondary contact
      operationId: SecondaryContacts_Get_5AE7C09D
      parameters:
      - name: contactId
        in: path
        description: The unique identifier for the primary contact.
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: The unique identifier (id) for a given contact.
        required: true
        schema:
          type: string
      - name: phoneFormat
        in: query
        description: ''
        required: false
        schema:
          type: string
          enum:
          - None
          - E164
      responses:
        '200':
          description: OK indicates that the request succeeded and that the requested information is in the response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
            application/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
            text/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
        '400':
          description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '404':
          description: NotFound indicates that the requested resource does not exist on the server.
        '500':
          description: Unexpected error.
      deprecated: false
    put:
      tags:
      - SecondaryContacts
      summary: Update an already existing secondary contact
      operationId: SecondaryContacts_Put_5975AAF3
      parameters:
      - name: contactId
        in: path
        description: The unique identifier for the primary contact.
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: The unique identifier (id) for a given secondary contact.
        required: true
        schema:
          type: string
      - name: phoneFormat
        in: query
        description: ''
        required: false
        schema:
          type: string
          enum:
          - None
          - E164
      responses:
        '200':
          description: OK indicates that the request succeeded and that the requested information is in the response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
            application/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
            text/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
        '400':
          description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '404':
          description: NotFound indicates that the requested resource does not exist on the server.
        '500':
          description: Unexpected error.
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
          application/xml:
            schema:
              $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
          text/xml:
            schema:
              $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
        description: The contact definition.
        required: true
    delete:
      tags:
      - SecondaryContacts
      summary: Delete an existing secondary contact
      operationId: SecondaryContacts_Delete_33369209
      parameters:
      - name: contactId
        in: path
        description: The unique identifier for the primary contact.
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: The unique identifier (id) for a given secondary contact.
        required: true
        schema:
          type: string
      responses:
        '204':
          description: NoContent indicates that the request has been successfully processed and that the response is intentionally blank.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/System.Object'
            application/xml:
              schema:
                $ref: '#/components/schemas/System.Object'
            text/xml:
              schema:
                $ref: '#/components/schemas/System.Object'
        '400':
          description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '404':
          description: NotFound indicates that the requested resource does not exist on the server.
        '500':
          description: Unexpected error.
      deprecated: false
    patch:
      tags:
      - SecondaryContacts
      summary: Update (partially) an already existing secondary contact
      operationId: SecondaryContacts_Patch_29CC2E85
      parameters:
      - name: contactId
        in: path
        description: The unique identifier for the primary contact.
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: The unique identifier (id) for a given secondary contact.
        required: true
        schema:
          type: string
      - name: phoneFormat
        in: query
        description: ''
        required: false
        schema:
          type: string
          enum:
          - None
          - E164
      responses:
        '200':
          description: OK indicates that the request succeeded and that the requested information is in the response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
            application/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
            text/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
        '400':
          description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '404':
          description: NotFound indicates that the requested resource does not exist on the server.
        '500':
          description: Unexpected error.
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
          application/xml:
            schema:
              $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
          text/xml:
            schema:
              $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
        description: The contact definition.
        required: true
  /api/contacts/{contactId}/secondary-contacts:
    get:
      tags:
      - SecondaryContacts
      summary: Get all secondary contacts matching an (optional) OData query
      operationId: SecondaryContacts_Get_CD9BB980
      parameters:
      - name: contactId
        in: path
        description: The unique identifier for the primary contact.
        required: true
        schema:
          type: string
      - name: phoneFormat
        in: query
        description: ''
        required: false
        schema:
          type: string
          enum:
          - None
          - E164
      responses:
        '200':
          description: OK indicates that the request succeeded and that the requested information is in the response.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
            application/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
            text/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '500':
          description: Unexpected error.
      deprecated: false
    post:
      tags:
      - SecondaryContacts
      summary: Create a new secondary contact
      operationId: SecondaryContacts_Post_C7CBE102
      parameters:
      - name: contactId
        in: path
        description: The unique identifier for the primary contact.
        required: true
        schema:
          type: string
      - name: phoneFormat
        in: query
        description: ''
        required: false
        schema:
          type: string
          enum:
          - None
          - E164
      responses:
        '201':
          description: Created indicates that the request resulted in a new resource created before the response was sent.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
            application/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
            text/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
        '400':
          description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '404':
          description: NotFound indicates that the requested resource does not exist on the server.
        '500':
          description: Unexpected error.
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
          application/xml:
            schema:
              $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
          text/xml:
            schema:
              $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/act.web.api.models.Contacts.Contact'
        description: The contact definition.
        required: true
  /api/contacts/{contactId}/secondary-contacts/{id}/promote:
    put:
      tags:
      - SecondaryContacts
      summary: Promote secondary contact to primary
      operationId: SecondaryContacts_PutPromote_BAF24408
      parameters:
      - name: contactId
        in: path
        description: The unique identifier for the primary contact.
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: The unique identifier (id) for a given secondary contact.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK indicates that the request succeeded and that the requested information is in the response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/System.Object'
            application/xml:
              schema:
                $ref: '#/components/schemas/System.Object'
            text/xml:
              schema:
                $ref: '#/components/schemas/System.Object'
        '400':
          description: BadRequest indicates that the request could not be understood by the server. BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.
        '401':
          description: Unauthorized indicates that the requested resource requires authentication. The WWW-Authenticate header contains the details of how to perform the authentication.
        '404':
          description: NotFound indicates that the requested resource does not exist on the server.
        '500':
          description: Unexpected error.
      deprecated: false
components:
  schemas:
    act.web.api.models.Address:
      description: A specific place where a person, business, or organization can be found and where physical mail can be received.
      type: object
      properties:
        line1:
          description: Primary street address
          type: string
        line2:
          description: Secondary street address
          type: string
        line3:
          description: Miscellaneous street address
          type: string
        city:
          description: An inhabited place of greater size, population, or importance than a town or village.
          type: string
        state:
          description: A nation or territory considered as an organized political community under one government.
          type: string
        postalCode:
          description: A code of letters and digits added to a postal address to aid in the sorting of mail.
          type: string
        country:
          description: A nation with its own government, occupying a particular territory.
          type: string
        latitude:
          format: double
          description: The angular distance of a place north or south of the earth's equator, or of a celestial object north or south of the celestial equator, usually expressed in degrees and minutes.
          type: number
        longitude:
          format: double
          description: The angular distance of a place east or west of the meridian at Greenwich, England, or west of the standard meridian of a celestial object, usually expressed in degrees and minutes.
          type: number
    System.Object:
      type: object
      properties: {}
    act.web.api.models.Contacts.Contact:
      description: The person who is designated for giving information or being a representative for an organization.
      type: object
      properties:
        id:
          description: The unique identifier (id) for this contact.
          type: string
        idStatus:
          description: The relative social or professional position of an individual within a group or organization.
          type: string
        isUser:
          description: An indicator if this contact is also a user within the system.
          type: boolean
        company:
          description: The organization that this contact is associated with.
          type: string
        department:
          description: An area of special expertise or responsibility.
          type: string
        companyID:
          description: The unique identifier (companyID) for a given companies.
          type: string
        contactType:
          description: 'The type of contact: Contact, Secondary, or User.'
          type: string
        namePrefix:
          description: A patronymic prefix.
          type: string
        firstName:
          description: A personal given name.
          type: string
        middleName:
          description: A name between one's first name and surname.
          type: string
        lastName:
          description: The family name or surname.
          type: string
        nameSuffix:
          description: Provides additional information about the person that identifies an individual position, educational degree, accreditation, orffice, or honors.
          type: string
        fullName:
          description: The first name, any middle names, and surname of a contact.  This may also include name prefixes and sufixes that are defined within Act!
          type: string
        isFavorite:
          description: Assign this contact as a favorite.
          type: boolean
        isImported:
          description: Identifies last communication or action with a contact.
          type: boolean
        importDate:
          format: date-time
          description: This readonly property displays the date that the opportunity was imported into the system.
          type: string
        isPrivate:
          description: Identifies last communication or action with a contact.
          type: boolean
        acl:
          description: Access Levels
          type: string
        lastResults:
          description: Identifies last communication or action with a contact.
          type: string
        lastEmail:
          format: date-time
          description: ''
          type: string
        lastAttempt:
          format: date-time
          description: ''
          type: string
        lastReach:
          format: date-time
          description: ''
          type: string
        lastMeeting:
          format: date-time
          description: ''
          type: string
        lastLetterSent:
          format: date-time
          description: ''
          type: string
        messengerID:
          description: An online identifier alias.
          type: string
        referredBy:
          description: Indicates how this contact came about.
          type: string
        salutation:
          description: A gesture or utterance made as a greeting or acknowledgment.
          type: string
        jobTitle:
          description: The title or position this contact holds.
          type: string
        amaScore:
          format: int32
          description: The contact's
          type: integer
        emailAddress:
          description: A unique electronic address that an individual can be contacted.
          type: string
        altEmailAddress:
          description: A unique electronic address that an individual can be contacted.
          type: string
        personalEmailAddress:
          description: A unique electronic address that an individual can be contacted.
          type: string
        website:
          description: The contact's web site.
          type: string
        birthday:
          format: date-time
          description: The anniversary of the day on which a person was born.
          type: string
        businessAddress:
          $ref: '#/components/schemas/act.web.api.models.Address'
          description: The contact's business address.
        businessPhone:
          description: The contact's business phone number.
          type: string
        businessExtension:
          description: The contact's business phone number extension.
          type: string
        businessCountryCode:
          format: int32
          description: The contact's business phone country code.
          type: integer
        businessMaskFormat:
          description: The contact's business phone mask format.
          type: string
        mobilePhone:
          description: The contact's mobile phone number.
          type: string
        mobileExtension:
          description: The contact's mobile phone extension.
          type: string
        mobileCountryCode:
          format: int32
          description: The contact's mobile phone country code.
          type: integer
        mobileMaskFormat:
          description: The contact's mobile phone mask format.
          type: string
        faxPhone:
          description: The contact's fax phone number.
          type: string
        faxExtension:
          description: The contact's fax phone number extension.
          type: string
        faxCountryCode:
          format: int32
          description: The contact's fax phone country code.
          type: integer
        faxMaskFormat:
          description: The contact's fax phone mask format.
          type: string
        homeAddress:
          $ref: '#/components/schemas/act.web.api.models.Address'
          description: The contact's home address.
        homePhone:
          description: The contact's home phone number.
          type: string
        homeExtension:
          description: The contact's home phone extension.
          type: string
        homeCountryCode:
          format: int32
          description: The contact's home phone country code.
          type: integer
        homeMaskFormat:
          description: The contact's home phone mask format.
          type: string
        alternatePhone:
          description: The contact's alternate phone number.
          type: string
        alternateExtension:
          description: The contact's alternate phone number extension.
          type: string
        alternateCountryCode:
          format: int32
          description: The contact's alternate phone country code.
          type: integer
        alternateMaskFormat:
          description: The contact's alternate phone mask.
          type: string
        pagerPhone:
          description: The contact's pager phone number.
          type: string
        pagerExtension:
          description: The contact's pager phone number extension
          type: string
        pagerCountryCode:
          format: int32
          description: The contact's pager phone country code.
          type: integer
        pagerMaskFormat:
          description: The contact's pager phone mask.
          type: string
        aemOptOut:
          description: ''
          type: boolean
        aemBounceBack:
          description: ''
          type: boolean
        recordManagerID:
          description: The record manager.
          type: string
        quickbooksId:
          description: Quickbooks external Id to match record with quickbooks contact
          type: string
        nylasContactId:
          description: Nylas contact Id to match record with a contact
          type: string
        customFields:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/System.Object'
        created:
          format: date-time
          type: string
        edited:
          format: date-time
          type: string
        editedBy:
          type: string
        recordManager:
          type: string