Skip to content
Talk to an Engineer Dashboard

Connect to Dynamo Software API to access investment management, CRM, and reporting data.

Dynamo Software logo

Supports authentication: Bearer Token

Delete multiple entities in Dynamo Software using bulk import.

NameTypeRequiredDescription
entityNamestringYesThe name of the Dynamo entity whose records will be deleted (e.g., ‘contact’, ‘activity’).
itemsarray<object>YesA required array of entity objects to delete. Each object should contain ‘_id’ or the internal ID property for the entity.

Create or update multiple entities in Dynamo Software using bulk import.

NameTypeRequiredDescription
entityNamestringYesThe name of the Dynamo entity to bulk create or update records for (e.g., ‘contact’, ‘activity’).
importActionstringNoControls the import behavior. Default is ‘updateorcreate’. ‘create’: only creates new records; ‘update’: only updates existing matches; ‘updateorcreate’: updates if match found, creates if not.
itemsarray<object>YesA required array of entity objects to create or update. Each object should contain the key property values plus any additional fields to set.
keyPropertiesarray<string>YesA required set of property names which combined determine the unique identity of each entity for matching purposes.
skipColumnIfSourceHasNoValuebooleanNoDefault false. When true, blank or null property values in the input are ignored and will not overwrite existing data. When false (default), blank values will clear existing property values.
skipIfPropertyHasNoValuebooleanNoDefault true. When true, properties not present in a given item will not overwrite existing values for that item. When false, all items must contain the same properties and unspecified values will be overwritten.

Create a new document or update an existing one based on key columns in Dynamo.

NameTypeRequiredDescription
contentstringNoThe document file contents encoded as a base64 string. Required when x_ishyperlink is false (default). Maps to the ‘_content’ field in the API body.
extensionstringNoThe file extension of the document including the dot prefix. Required when x_ishyperlink is false.
hyperlinkstringNoThe URL for a hyperlink document. Required when x_ishyperlink is true. Must be a valid URL.
titlestringYesThe display title of the document. Required when creating a file upload (x_ishyperlink=false) or a hyperlink (x_ishyperlink=true).
x_identifierbooleanNoWhen true, the response will include the Identifier property (Name (ID)) for the document. Default is true.
x_importactionstringNoControls the create/update behavior when x_keycolumns is provided. Default is ‘updateorcreate’. Only applies when x_keycolumns is also set.
x_ishyperlinkbooleanNoWhen set to true, the document is created as a web link (hyperlink) instead of a file upload. Default is false.
x_keycolumnsstringNoA set of comma-separated column names used to determine the identity of a specific document for upsert. The ‘_content’ column cannot be used as a key column.
x_keycolumns_encodedbooleanNoWhen true, the x_keycolumns value must be provided as a base64-encoded string. Default is false.
x_resolvedbooleanNoWhen false, reference properties in the response are returned as objects (with _id and _es) instead of resolved primitive values. Default is true.

Returns decrypted value of an encrypted property for a given entity record.

NameTypeRequiredDescription
entityNamestringYesThe name of the Dynamo entity that contains the encrypted property (e.g., ‘Contact’, ‘Activity’).
idstringYesThe unique identifier (UUID/entity key) of the specific entity record whose encrypted property you want to decrypt.
propertystringYesThe name of the encrypted property to decrypt. Must be a property that is configured as encrypted in Dynamo.

Returns a single instance of a Dynamo entity by its ID with optional column selection and formatting controls.

NameTypeRequiredDescription
entityNamestringYesThe name of the Dynamo entity type to retrieve a record from (e.g., ‘activity’, ‘contact’).
idstringYesThe unique identifier (UUID) of the specific entity record to retrieve.
x_columnsstringNoComma-separated list of property names to include in the response. Reduces bandwidth by returning only specified fields.
x_columns_encodedbooleanNoWhen true, the x_columns value must be provided as a base64-encoded string. Default is false.
x_resolvedbooleanNoWhen false, reference/lookup properties are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.
x_showlabelsbooleanNoWhen true, property keys in the response use display labels instead of internal property names. Default is false.

Deletes a single instance of the specified Dynamo entity by ID.

NameTypeRequiredDescription
entityNamestringYesThe name of the Dynamo entity type from which to delete the record (e.g., ‘activity’, ‘contact’).
idstringYesThe unique identifier (UUID) of the specific entity record to delete.

Returns the extended schema definition of a specified Dynamo entity, including detailed metadata and optional permissions.

NameTypeRequiredDescription
entityNamestringYesThe name of the Dynamo entity to retrieve the extended schema for (e.g., ‘activity’, ‘contact’, ‘document’).
permissionsbooleanNoWhen true, the schema response includes information about the current user’s permissions to perform operations on each property. Default is false.

Returns all properties for a specified Dynamo entity.

NameTypeRequiredDescription
entityNamestringYesThe name of the Dynamo entity whose properties (field list) you want to retrieve.

Creates or updates an entity item in Dynamo using PUT semantics. Supports key columns or ID-based upsert via headers or request body.

NameTypeRequiredDescription
bodyobjectYesThe entity field values to create or update. Pass a JSON object with the Dynamo property names as keys.
entityNamestringYesThe name of the Dynamo entity type to create or update (e.g., ‘activity’, ‘contact’, ‘document’).
x_identifierbooleanNoWhen true, the response includes the Identifier property (Name (ID)) for the entity. Default is true.
x_importactionstringNoControls the create/update behavior when x_keycolumns is set. Default is ‘updateorcreate’. Only applies when x_keycolumns is also provided.
x_keycolumnsstringNoComma-separated column names used to determine the identity of a specific entity for upsert matching.
x_keycolumns_encodedbooleanNoWhen true, the x_keycolumns value must be provided as a base64-encoded string. Default is false.
x_resolvedbooleanNoWhen false, reference/lookup properties are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.

Returns the schema definition of a specified Dynamo entity.

NameTypeRequiredDescription
entityNamestringYesThe name of the Dynamo entity whose field schema you want to retrieve (e.g., ‘activity’, ‘contact’, ‘document’).
permissionsbooleanNoWhen true, the schema response includes information about the current user’s permissions to perform operations on each property. Default is false.

Returns total count of items for a given Dynamo entity.

NameTypeRequiredDescription
entityNamestringYesThe name of the Dynamo entity whose total record count you want to retrieve.

Updates or creates an instance of a Dynamo entity identified by ID and returns the updated item.

NameTypeRequiredDescription
bodyobjectYesKey-value pairs of entity properties to update. Property names must match the entity schema exactly. Example: {"Subject": "Follow-up call", "Body": "Discuss proposal"}
entityNamestringYesThe name of the Dynamo entity type containing the record to update (e.g., ‘activity’, ‘contact’).
idstringYesThe unique identifier (UUID) of the specific entity record to update or create.
x_identifierbooleanNoWhen true, the response includes the Identifier property (Name (ID)) for the entity. Default is true.
x_resolvedbooleanNoWhen false, reference/lookup properties in the response are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.

Creates or updates an entity item in Dynamo. Supports key-based upsert using headers or ID in request body.

NameTypeRequiredDescription
bodyobjectYesJSON object containing the entity field values to create or update. Property names must match Dynamo field names exactly.
entityNamestringYesThe name of the Dynamo entity type to create or update a record for (e.g., ‘activity’, ‘contact’).
x_identifierbooleanNoWhen true, the response includes the Identifier property (Name (ID)) for the entity. Default is true.
x_importactionstringNoControls the create/update behavior when x_keycolumns is provided. Default is ‘updateorcreate’.
x_keycolumnsstringNoComma-separated column names that together uniquely identify an entity for upsert matching.
x_keycolumns_encodedbooleanNoWhen true, the x_keycolumns value must be provided as a base64-encoded string. Default is false.
x_resolvedbooleanNoWhen false, reference/lookup properties in the response are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.

Returns a single Dynamo document by its unique ID with optional column filtering and formatting controls.

NameTypeRequiredDescription
idstringYesThe unique identifier (UUID) of the document to retrieve.
x_columnsstringNoComma-separated list of property names to include in the response. Reduces bandwidth.
x_columns_encodedbooleanNoWhen true, the x_columns value must be provided as a base64-encoded string. Default is false.
x_identifierbooleanNoWhen true, the response includes the Identifier property (Name (ID)) for the document. Default is true.
x_resolvedbooleanNoWhen false, reference/lookup properties are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.
x_showlabelsbooleanNoWhen true, property keys in the response use display labels instead of internal property names. Default is false.

Returns an extended schema of the Dynamo Document entity, including detailed metadata and optional permission information.

NameTypeRequiredDescription
permissionsbooleanNoWhen true, the extended schema response includes information about the current user’s permissions to perform operations on each property. Default is false.

Returns all properties available for the document entity in Dynamo.

Returns the schema definition of the Dynamo document entity, optionally including permission metadata.

NameTypeRequiredDescription
permissionsbooleanNoWhen true, the schema response includes information about the current user’s permissions to perform operations on each document property. Default is false.

Returns upload restrictions for Dynamo Document entity such as size limits, allowed types, and validation rules.

Retrieve documents from Dynamo with filters, sorting, pagination.

NameTypeRequiredDescription
idstringNoOptional document UUID. When provided, the response contains only the document matching this ID.
x_columnsstringNoComma-separated list of property names to include in the response. Reduces bandwidth by returning only specified fields.
x_columns_encodedbooleanNoWhen true, the x_columns value must be provided as a base64-encoded string. Default is false.
x_resolvedbooleanNoWhen false, reference/lookup properties are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.
x_showlabelsbooleanNoWhen true, property keys in the response use display labels instead of internal property names. Default is false.
x_sortstringNoSorting expression for the returned documents. Supports single or multiple property sort with direction.
x_sort_encodedbooleanNoWhen true, the x_sort value must be provided as a base64-encoded string. Default is false.

Returns the total number of document entities in Dynamo.

Returns all available Dynamo entities with optional filtering support.

NameTypeRequiredDescription
x_filterstringNoFilter entities whose properties match the given criteria. Format: propertyA=value1, propertyB=value2.

Returns all items for a given Dynamo entity with support for filtering, pagination, sorting, and column selection.

NameTypeRequiredDescription
entityNamestringYesThe name of the Dynamo entity type to retrieve records from (e.g., ‘activity’, ‘contact’, ‘document’).
idstringNoOptional UUID to filter to a single entity record. When provided, only the record matching this ID is returned.
x_columnsstringNoComma-separated list of property names to include in the response. Reduces bandwidth by returning only specified fields.
x_columns_encodedbooleanNoWhen true, the x_columns value must be provided as a base64-encoded string. Default is false.
x_resolvedbooleanNoWhen false, reference/lookup properties are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.
x_showlabelsbooleanNoWhen true, property keys in the response use display labels instead of internal property names. Default is false.
x_sortstringNoSorting expression for the returned records. Supports single or multiple property sort with direction.
x_sort_encodedbooleanNoWhen true, the x_sort value must be provided as a base64-encoded string. Default is false.

Returns a brief schema for all available Dynamo entities with optional filtering, permission details, and extended metadata.

NameTypeRequiredDescription
fullbooleanNoWhen true, returns the complete schema containing all properties that can be passed to the x-filter parameter. Default is false.
permissionsbooleanNoWhen true, each entity schema includes the current user’s permissions to perform operations on that entity. Default is false.
showConfirmDeletebooleanNoWhen true, the schema response includes the showConfirmDelete property for each entity. Default is false.
showSubtitlebooleanNoWhen true, the schema response includes the Subtitle property name for each entity. Default is false.
x_filterstringNoFilters entities whose properties match the given schema criteria. Format: propertyA=value1, propertyB=value2.

Removes the user’s API key from the server cache. The key remains valid but will be revalidated on next request.

Retrieves data matching saved search criteria from Dynamo using advanced filter queries.

NameTypeRequiredDescription
allbooleanNoWhen true, returns all matching results across all pages instead of only the first page. Use with caution for large result sets.
querystringYesJSON-formatted advanced search query in Dynamo’s ‘advf’ format. Copy this from the Dynamo site’s advanced search panel using the ‘API Query’ button.
utcOffsetnumberNoThe difference in hours from Coordinated Universal Time (UTC) to use for date/time calculations in the search. Default is 0 (UTC).
x_columnsstringNoComma-separated list of property names to include in each result. Reduces bandwidth.
x_columns_encodedbooleanNoWhen true, the x_columns value must be provided as a base64-encoded string. Default is false.
x_resolvedbooleanNoWhen false, reference/lookup properties are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.
x_showlabelsbooleanNoWhen true, property keys in the response use display labels instead of internal property names. Default is false.
x_sortstringNoSorting expression for the search results. Supports single or multiple property sort.
x_sort_encodedbooleanNoWhen true, the x_sort value must be provided as a base64-encoded string. Default is false.

Creates a new version of a Dynamo document by updating it using its ID. Optionally updates title or creates hyperlink versions.

NameTypeRequiredDescription
_contentstringNoThe new document file content encoded as a base64 string. Providing this creates a new version of the document.
hyperlinkstringNoThe URL for a hyperlink document. Required when x-ishyperlink is true. Must be a valid URL.
idstringYesThe unique identifier (UUID) of the document to update.
titlestringNoOptional new title for the document. When updated, the title change applies to ALL versions of the document, not just the current version.
x-identifierbooleanNoWhen true, the response includes the Identifier property (Name (ID)) for the document. Default is true.
x-ishyperlinkbooleanNoWhen true, indicates that the document being updated is a hyperlink (URL) rather than a file. Default is false.
x-resolvedbooleanNoWhen false, reference/lookup properties in the response are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.

Create or update a document in Dynamo using key columns via PUT operation.

NameTypeRequiredDescription
contentstringNoThe document file contents encoded as a base64 string. Required when x_ishyperlink is false. Maps to ‘_content’ in the API body.
extensionstringNoThe file extension including the dot prefix. Required when x_ishyperlink is false.
hyperlinkstringNoThe URL for a hyperlink document. Required when x_ishyperlink is true. Must be a valid URL.
titlestringYesThe display title of the document. Required for all document types (file or hyperlink).
x_identifierbooleanNoWhen true, the response includes the Identifier property (Name (ID)) for the document. Default is true.
x_importactionstringNoControls the create/update behavior when x_keycolumns is provided. Default is ‘updateorcreate’.
x_ishyperlinkbooleanNoWhen true, the document is created/updated as a web hyperlink instead of a file upload. Default is false.
x_keycolumnsstringNoComma-separated column names used to determine the identity of a specific document for upsert matching. The ‘_content’ column cannot be used as a key column.
x_keycolumns_encodedbooleanNoWhen true, the x_keycolumns value must be provided as a base64-encoded string. Default is false.
x_resolvedbooleanNoWhen false, reference/lookup properties in the response are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.

Returns available views or items from a specified view with optional filtering, sorting, and column selection.

NameTypeRequiredDescription
pathstringNoThe path identifier of the view. If provided, returns all items matching that view’s search criteria. If omitted, returns a list of all available views.
utcOffsetnumberNoThe difference in hours from Coordinated Universal Time (UTC) for date/time calculations. Default is 0 (UTC).
x_columnsstringNoComma-separated list of additional property names to include in the response alongside the view’s default columns.
x_columns_encodedbooleanNoWhen true, the x_columns value must be provided as a base64-encoded string. Default is false.
x_resolvedbooleanNoWhen false, reference/lookup properties are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.
x_showlabelsbooleanNoWhen true, property keys in the response use display labels instead of internal property names. Default is false.
x_sortstringNoSort expression that overrides the view’s default sorting with higher priority.
x_sort_encodedbooleanNoWhen true, the x_sort value must be provided as a base64-encoded string. Default is false.

Retrieves items from a specified Dynamo view using optional filters and query rules.

NameTypeRequiredDescription
pathstringYesThe path identifier of the view to search. Required. Combined with optional filter rules in the request body to retrieve matching items.
querystringNoJSON string representing additional filter rules to apply on top of the view’s built-in search criteria. If omitted, only the view’s default criteria are used.
utcOffsetnumberNoThe difference in hours from Coordinated Universal Time (UTC) for date/time calculations. Default is 0 (UTC).
x_columnsstringNoComma-separated list of additional property names to include in the response alongside the view’s default columns.
x_columns_encodedbooleanNoWhen true, the x_columns value must be provided as a base64-encoded string. Default is false.
x_resolvedbooleanNoWhen false, reference/lookup properties are returned as raw objects (with _id and _es) instead of resolved display values. Default is true.
x_showlabelsbooleanNoWhen true, property keys in the response use display labels instead of internal property names. Default is false.
x_sortstringNoSort expression that overrides the view’s default sorting with higher priority.
x_sort_encodedbooleanNoWhen true, the x_sort value must be provided as a base64-encoded string. Default is false.

Returns a list of available SQL views from Dynamo.

Returns data from a specific SQL view in Dynamo using the view name.

NameTypeRequiredDescription
viewNamestringYesThe name of the SQL view to retrieve, without the ‘EXPORTSQL_’ prefix. The API appends this prefix automatically when calling GET /api/v2.2/View/sql/EXPORTSQL_{viewName}.

Executes a SQL stored procedure in Dynamo and returns the result.

NameTypeRequiredDescription
parametersobjectNoOptional JSON object containing named parameters to pass to the stored procedure. The object’s keys and values depend on the specific stored procedure’s parameter requirements.
spNamestringYesThe name of the SQL stored procedure to execute, without the ‘EXPORTSQLSP_’ prefix. The API prepends this prefix automatically when calling POST /api/v2.2/View/sql/EXPORTSQLSP_{spName}.

Triggers a workflow action button operation on a specific entity record in Dynamo.

NameTypeRequiredDescription
entitystringYesThe display name of the Dynamo entity type that contains the action button. Must match the entity name as configured in Dynamo.
entity_keystringYesThe UUID of the specific entity record on which the action button workflow will be triggered.
propertystringYesThe name of the action button property on the entity that maps to the workflow to trigger.

Triggers a custom workflow operation in Dynamo by operation name with optional parameters.

NameTypeRequiredDescription
operationstringYesThe name of the custom workflow operation to trigger. Used as the last segment of the URL: POST /api/v2.2/Workflow/CustomOperation/{operation}.
parametersobjectNoOptional JSON object containing named parameters to pass to the custom workflow operation. The keys and values depend on what the specific operation expects.

Triggers all workflows defined to run on a specific schedule by schedule ID in Dynamo.

NameTypeRequiredDescription
idstringYesThe UUID of the Dynamo workflow schedule to trigger. All workflows associated with this schedule will be executed immediately, as if the schedule’s configured time had been reached.