{ "opencollection": "1.0.0", "info": { "name": "Velaris Public Activity Entity Management V1 API", "version": "1.0.0" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "Entity Management V1", "type": "folder" }, "items": [ { "info": { "name": "Get All Organizations V1", "type": "http" }, "http": { "method": "GET", "url": "https://api.euw1.velaris.io/core/organizations" }, "docs": "

Note: Please use the V2 API for fetching data, as the V1 API is restricted to returning only a limited number of responses. The V2 API does not have this limitation and provides more efficient data retrieval.

\n

To filter organizations by custom fields

\n

/organizations?{custom_field_name}={value}

\n

Example

\n

/organizations?zapier=true

\n" }, { "info": { "name": "Create Organization", "type": "http" }, "http": { "method": "POST", "url": "https://api.euw1.velaris.io/core/organizations", "body": { "type": "json", "data": "{}" } }, "docs": "

Create New Organization.

\n
Request body guide
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
externalIdUse externalId to add the external id of the organization.
propertiesUse properties to add all the custom fields.
contactsUse c" }, { "info": { "name": "Get Organizations By ID", "type": "http" }, "http": { "method": "GET", "url": "https://api.euw1.velaris.io/core/organizations/:organizationId" }, "docs": "

Example:

\n
    \n
  • With external id: /organizations/extid-id
  • \n
  • With internal id: /organizations/srcid-id
  • \n
\n" }, { "info": { "name": "Update Organization", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/organizations/:organizationId", "body": { "type": "json", "data": "{}" } }, "docs": "

Example:

\n
    \n
  • With external id: /oganizations/extid-id

    \n
  • \n
  • With internal id: /organizations/srcid-id

    \n
  • \n
\n
Reqeust body guide
\n

Follow the organization create guide.

\n

Archived Organizations cannot be updated.

\n
Account Linking
\n

Cannot link accounts to organization when updating organization. There is seperate A" }, { "info": { "name": "Churn organization", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/organizations/:organizationId/churn-status", "body": { "type": "json", "data": "{}" } }, "docs": "

Example:

\n
    \n
  • With external id: /organizations/extid-id/churn-status
  • \n
  • With internal id: /organizations/srcid-id/churn-status
  • \n
\n" }, { "info": { "name": "Archive Organization", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/organizations/:organizationId/archive" }, "docs": "

Example:

\n
    \n
  • With external id:/organizations/extid-id/archive
  • \n
  • With internal id: /organizations/srcid-id/archive
  • \n
\n" }, { "info": { "name": "Restore Organization", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/organizations/:organizationId/restore" }, "docs": "Restore Organization" }, { "info": { "name": "Get All Accounts V1", "type": "http" }, "http": { "method": "GET", "url": "https://api.euw1.velaris.io/core/accounts" }, "docs": "

Note: Please use the V2 API for fetching data, as the V1 API is restricted to returning only a limited number of responses. The V2 API does not have this limitation and provides more efficient data retrieval.

\n

To filter accounts by custom fields

\n

/accounts?{custom_field_name}={value}

\n

Example

\n

/accounts?zapier=true

\n" }, { "info": { "name": "Create Account", "type": "http" }, "http": { "method": "POST", "url": "https://api.euw1.velaris.io/core/accounts", "body": { "type": "json", "data": "{}" } }, "docs": "

Create New Account.

\n
Request body guide
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n<" }, { "info": { "name": "Get Account By ID", "type": "http" }, "http": { "method": "GET", "url": "https://api.euw1.velaris.io/core/accounts/:accountId" }, "docs": "

Example:

\n
    \n
  • With external id: /accounts/extid-id
  • \n
  • With internal id: /accounts/srcid-id
  • \n
\n" }, { "info": { "name": "Update Account", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/accounts/:accountId", "body": { "type": "json", "data": "{}" } }, "docs": "

Example:

\n
    \n
  • With external id: /accounts/extid-id
  • \n
  • With internal id: /accounts/srcid-id
  • \n
\n" }, { "info": { "name": "Churn Account", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/accounts/:accountId/churn-status", "body": { "type": "json", "data": "{}" } }, "docs": "

Example:

\n
    \n
  • With external id: /accounts/extid-id
  • \n
  • With internal id: /accounts/srcid-id
  • \n
\n" }, { "info": { "name": "Archive Account", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/accounts/:accountId/archive" }, "docs": "

Example:

\n
    \n
  • With external id: /accounts/extid-id
  • \n
  • With internal id: /accounts/srcid-id
  • \n
\n" }, { "info": { "name": "Restore Account", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/accounts/:organizationId/restore" }, "docs": "

Example:

\n
    \n
  • With external id: /accounts/extid-id
  • \n
  • With internal id: /accounts/srcid-id
  • \n
\n" }, { "info": { "name": "Change Parent Entity", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/accounts/:accountId/parent-entity", "body": { "type": "json", "data": "{}" } }, "docs": "

Change or assign parent organization.

\n" }, { "info": { "name": "Get All Contacts V1", "type": "http" }, "http": { "method": "GET", "url": "https://api.euw1.velaris.io/core/contacts" }, "docs": "

Note: Please use the V2 API for fetching data, as the V1 API is restricted to returning only a limited number of responses. The V2 API does not have this limitation and provides more efficient data retrieval.

\n

To filter contacts by custom fields

\n

/contacts?{custom_field_name}={value}

\n

Example

\n

/contacts?zapier=true

\n" }, { "info": { "name": "Create Contacts", "type": "http" }, "http": { "method": "POST", "url": "https://api.euw1.velaris.io/core/contacts", "body": { "type": "json", "data": "{}" } }, "docs": "

Create new contact

\n

Create New Organiztion.

\n
Request body guide
\n
FieldDescription
externalIdUse externalId to add the external id of the organization.
organizationExternalIdUse organizationExternalId to link an organization to the current account.
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldDescription
externalIdUse externalId to add external id of the contact
emailUse email to add email id of the contact
propertiesUse" }, { "info": { "name": "Get Contacts By Id", "type": "http" }, "http": { "method": "GET", "url": "https://api.euw1.velaris.io/core/contacts/:contactId" }, "docs": "

Example:

\n
    \n
  • With external id: /contacts/extid-id
  • \n
  • With internal id: /contacts/srcid-id
  • \n
\n" }, { "info": { "name": "Update Contact", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/contacts/:contactId", "body": { "type": "json", "data": "{}" } }, "docs": "

Example:

\n
    \n
  • With external id: /contacts/extid-id
  • \n
  • With internal id: /contacts/srcid-id
  • \n
\n" }, { "info": { "name": "Archive Contact", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/contacts/:contactId/archive" }, "docs": "

Example:

\n
    \n
  • With external id: /contacts/extid-id
  • \n
  • With internal id: /contacts/srcid-id
  • \n
\n" }, { "info": { "name": "Restore Contact", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/contacts/:contactId/restore" }, "docs": "

Example:

\n
    \n
  • With external id: /contacts/extid-id
  • \n
  • With internal id: /contacts/srcid-id
  • \n
\n" }, { "info": { "name": "Get All Opportunities V1", "type": "http" }, "http": { "method": "GET", "url": "https://api.euw1.velaris.io/core/opportunities" }, "docs": "

Note: Please use the V2 API for fetching data, as the V1 API is restricted to returning only a limited number of responses. The V2 API does not have this limitation and provides more efficient data retrieval.

\n

To filter opportunities by custom fields

\n

/opportunities?{custom_field_name}={value}

\n" }, { "info": { "name": "Create Opportunity", "type": "http" }, "http": { "method": "POST", "url": "https://api.euw1.velaris.io/core/opportunities", "body": { "type": "json", "data": "{}" } }, "docs": "
    \n
  • parentEntity types - organization, account

    \n
  • \n
  • parent entity id or external id can be used

    \n
  • \n
\n
\"parentEntity\": {\n  \"type\": \"account\",\n  \"externalId\": \"account-external-id\"\n}\n\n
    \n
  • contact email addresses should be provided. if a contact does not exist with the given email, new contact will be created.

    \n
  • \n
  • links: Use links to link custom objects with opp" }, { "info": { "name": "Get Opportunities By Id", "type": "http" }, "http": { "method": "GET", "url": "https://api.euw1.velaris.io/core/opportunities/:pipelineId" }, "docs": "

    Example

    \n
      \n
    • With external id: /opportunities/extid-id
    • \n
    • With internal id: /opportunities/srcid-id
    • \n
    \n" }, { "info": { "name": "Update Opportunity", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/opportunities/:opportunityId", "body": { "type": "json", "data": "{}" } }, "docs": "
      \n
    • With external id: /opportunities/extid-id

      \n
    • \n
    • With internal id: /opportunities/srcid-id

      \n
    • \n
    • parent entity cannot be changed after creation.

      \n
    • \n
    • contact email addresses should be provided. if a contact does not exist with the given email, new contact will be created.

      \n
    • \n
    \n" }, { "info": { "name": "Archive Opportunity", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/opportunities/:id/archive" }, "docs": "

    Example

    \n
      \n
    • With external id: /opportunities/extid-id
    • \n
    • With internal id: /opportunities/srcid-id
    • \n
    \n" }, { "info": { "name": "Restore Opportunity", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/opportunities/:opportunityId/restore" }, "docs": "

    Example

    \n
      \n
    • With external id: /opportunities/extid-id
    • \n
    • With internal id: /opportunities/srcid-id
    • \n
    \n" }, { "info": { "name": "Get All Risks V1", "type": "http" }, "http": { "method": "GET", "url": "https://api.euw1.velaris.io/core/risks" }, "docs": "

    Note: Please use the V2 API for fetching data, as the V1 API is restricted to returning only a limited number of responses. The V2 API does not have this limitation and provides more efficient data retrieval.

    \n

    To filter risks by custom fields

    \n

    /risks?{custom_field_name}={value}

    \n" }, { "info": { "name": "Create Risk", "type": "http" }, "http": { "method": "POST", "url": "https://api.euw1.velaris.io/core/risks", "body": { "type": "json", "data": "{}" } }, "docs": "
      \n
    • parentEntity types - organization, account

      \n
    • \n
    • parent entity id or external id can be used

      \n
    • \n
    \n
    \"parentEntity\": {\n  \"type\": \"account\",\n  \"externalId\": \"account-external-id\"\n}\n\n
      \n
    • contact email addresses should be provided. if a contact does not exist with the given email, new contact will be created.

      \n
    • \n
    • links: Use links to link custom objects with ris" }, { "info": { "name": "Get Risk By Id", "type": "http" }, "http": { "method": "GET", "url": "https://api.euw1.velaris.io/core/risks/:riskId" }, "docs": "

      Example

      \n
        \n
      • With external id: /risks/extid-id
      • \n
      • With internal id: /risks/srcid-id
      • \n
      \n" }, { "info": { "name": "Update Risk", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/risks/:riskId", "body": { "type": "json", "data": "{}" } }, "docs": "
        \n
      • With external id:/risks/extid-id
      • \n
      • With internal id: /risks/srcid-id
      • \n
      • parent entity cannot be changed after creation.
      • \n
      • contact email addresses should be provided. if a contact does not exist with the given email, new contact will be created.
      • \n
      \n" }, { "info": { "name": "Archive Risk", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/risks/:riskId/archive" }, "docs": "
        \n
      • With external id:/risks/extid-id
      • \n
      • With internal id: /risks/srcid-id
      • \n
      \n" }, { "info": { "name": "Restore Risks", "type": "http" }, "http": { "method": "PUT", "url": "https://api.euw1.velaris.io/core/risks/:riskId/restore" }, "docs": "
        \n
      • With external id:/risks/extid-id
      • \n
      • With internal id: /risks/srcid-id
      • \n
      \n" } ] } ], "bundled": true }