Act! CRM Custom Entities API

The Custom Entities API from Act! CRM — 2 operation(s) for custom entities.

Operations 5

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/custom/entities/{entityName}/{id} Get a custom entity record · Get a specific custom entity #
Ask an LLM
“How do I fetch one record of a custom entity type?”
“Can I look up a custom object record by its ID?”
Tell an agent
Get {entityName} record {id}.
Show custom record {id} of type {entityName}.
PUT /api/custom/entities/{entityName}/{id} Save a custom entity record at a given ID · Create a new custom entity #
Ask an LLM
“Can I write a custom entity record under an ID I choose?”
“What call puts a custom object record at a specific ID?”
Tell an agent
Save {entityName} record with ID {id}.
Put custom record {id} into entity {entityName}.
DELETE /api/custom/entities/{entityName}/{id} Delete a custom entity record · Delete an existing custom entity #
Ask an LLM
“How do I delete a record from a custom entity?”
“Can I permanently remove one custom object record?”
Tell an agent destructive · confirm first
Delete {entityName} record {id}.
Remove custom record {id} from entity {entityName}.
GET /api/custom/entities/{entityName} List a custom entity's records · Get all custom entity data matching an (optional) OData query #
Ask an LLM
“Which records exist for one of my custom entities?”
“Can I query a custom entity's data with OData?”
Tell an agent
List all {entityName} records.
Show the data stored in custom entity {entityName}.
POST /api/custom/entities/{entityName} Create a custom entity record · Create a new custom entity #
Ask an LLM
“How do I add a new record to a custom entity?”
“Can I create a custom object record and let the system assign its ID?”
Tell an agent
Create a new {entityName} record.
Add a record to custom entity {entityName}.

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-custom-entities-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

act-custom-entities-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: v1
  title: act.web.api Custom Entities API
servers:
- url: https://apimta.act.com/act.web.api
tags:
- name: Custom Entities
paths:
  /api/custom/entities/{entityName}/{id}:
    get:
      tags:
      - Custom Entities
      summary: Get a specific custom entity
      operationId: CustomEntities_Get_E50407CC
      parameters:
      - name: entityName
        in: path
        description: The name of the custom entity.
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: The unique identifier (id) for a given custom entity.
        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/act.web.api.models.CustomEntity'
            application/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.CustomEntity'
            text/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.CustomEntity'
        '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:
      - Custom Entities
      summary: Create a new custom entity
      operationId: CustomEntities_Put_E2EE1D22
      parameters:
      - name: entityName
        in: path
        description: The name of the custom entity.
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: The unique identifier (id) for a given custom entity.
        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/act.web.api.models.CustomEntity'
            application/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.CustomEntity'
            text/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.CustomEntity'
        '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:
              type: object
              additionalProperties:
                $ref: '#/components/schemas/System.Object'
          application/xml:
            schema:
              type: object
              additionalProperties:
                $ref: '#/components/schemas/System.Object'
          text/xml:
            schema:
              type: object
              additionalProperties:
                $ref: '#/components/schemas/System.Object'
          application/x-www-form-urlencoded:
            schema:
              type: object
              additionalProperties:
                $ref: '#/components/schemas/System.Object'
        description: The company definition.
        required: true
    delete:
      tags:
      - Custom Entities
      summary: Delete an existing custom entity
      operationId: CustomEntities_Delete_B426AB4B
      parameters:
      - name: entityName
        in: path
        description: The name of the custom entity.
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: The unique identifier (id) for a given custom entity.
        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
  /api/custom/entities/{entityName}:
    get:
      tags:
      - Custom Entities
      summary: Get all custom entity data matching an (optional) OData query
      operationId: CustomEntities_Get_534E3316
      parameters:
      - name: entityName
        in: path
        description: The name of the custom entity.
        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:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.CustomEntity'
            application/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.CustomEntity'
            text/xml:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/act.web.api.models.CustomEntity'
        '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.
        '500':
          description: Unexpected error.
      deprecated: false
    post:
      tags:
      - Custom Entities
      summary: Create a new custom entity
      operationId: CustomEntities_Post_4BE499F1
      parameters:
      - name: entityName
        in: path
        description: The name of the custom entity.
        required: true
        schema:
          type: string
      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.CustomEntity'
            application/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.CustomEntity'
            text/xml:
              schema:
                $ref: '#/components/schemas/act.web.api.models.CustomEntity'
        '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:
              type: object
              additionalProperties:
                $ref: '#/components/schemas/System.Object'
          application/xml:
            schema:
              type: object
              additionalProperties:
                $ref: '#/components/schemas/System.Object'
          text/xml:
            schema:
              type: object
              additionalProperties:
                $ref: '#/components/schemas/System.Object'
          application/x-www-form-urlencoded:
            schema:
              type: object
              additionalProperties:
                $ref: '#/components/schemas/System.Object'
        description: The company definition.
        required: true
components:
  schemas:
    act.web.api.models.CustomEntity:
      description: Represents the base properties of a custom table.
      type: object
      properties:
        id:
          description: The unique identifier (id) for this custom entity.
          type: string
        companies:
          description: List of companies that are associated to this custom entity.
          type: array
          items:
            $ref: '#/components/schemas/act.web.api.models.Companies.EmbeddedCompany'
        contacts:
          description: List of contacts that are associated to this custom entity.
          type: array
          items:
            $ref: '#/components/schemas/act.web.api.models.Contacts.EmbeddedContact'
        groups:
          description: List of groups that are associated to this custom entity.
          type: array
          items:
            $ref: '#/components/schemas/act.web.api.models.Groups.EmbeddedGroup'
        opportunity:
          description: List of opportunity that are associated to this custom entity.
          type: array
          items:
            $ref: '#/components/schemas/act.web.api.models.Opportunities.EmbeddedOpportunity'
        created:
          format: date-time
          description: The date that this record was created.
          type: string
        edited:
          format: date-time
          description: The date that this record was edited.
          type: string
        editedBy:
          description: The user's name that last editied this record.
          type: string
        recordOwner:
          description: The user's name that owners this record.
          type: string
    act.web.api.models.Companies.EmbeddedCompany:
      description: A company entity that displayed as a sub-child to a parent entity.
      type: object
      properties:
        id:
          description: Gets a unique identifier (id) for a given company.
          type: string
        name:
          description: Gets the name of the company.
          type: string
    act.web.api.models.Opportunities.EmbeddedOpportunity:
      description: An opportunity entity that displayed as a sub-child to a parent entity.
      type: object
      properties:
        id:
          description: Gets a unique identifier (id) for a given opportunity.
          type: string
        name:
          description: Gets the name of the opportunity.
          type: string
    act.web.api.models.Groups.EmbeddedGroup:
      description: An group entity that displayed as a sub-child to a parent entity.
      type: object
      properties:
        id:
          description: Gets a unique identifier (id) for a given group.
          type: string
        name:
          description: Gets the name of the group.
          type: string
    act.web.api.models.Contacts.EmbeddedContact:
      description: ''
      type: object
      properties:
        id:
          description: ''
          type: string
        displayName:
          description: ''
          type: string
          readOnly: true
        company:
          description: 'AS-1763 - API: Expose Opportunity Company name for use in Companion, removed [JsonIgnore]'
          type: string
        isInvited:
          description: Invited contact flag
          type: boolean
    System.Object:
      type: object
      properties: {}