> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/deltek-vantagepoint.md).

# Deltek Vantagepoint

Integration with Deltek Vantagepoint for running reports and reading Projects, Employees, Firms, and Contacts hub records.

### Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector           | Authentication |
| ------------------- | -------------- |
| Deltek Vantagepoint | Credentials    |

#### Deltek Vantagepoint

Connect to your Deltek Vantagepoint instance with a consumer key/secret and a user login to run reports and read hub records.

**Set up in Deltek Vantagepoint**

1. Prepare the Deltek Vantagepoint account or service that the workflow will access. Grant access to the required resources and operations.
2. **Database:** The Vantagepoint database to log into, shown in the Database Name field of the API Authorization form used to generate the secret.
3. **Consumer Key (Client ID):** The Consumer Key from Vantagepoint's API Authorization form.
4. **Consumer Secret:** The secret generated from the Consumer Key on the API Authorization form (Actions > Generate Secret). Regenerating it breaks every connection using the old secret until they are reconnected.
5. **Default Process Queue:** Optional. The Vantagepoint Process Queue that reports run on (Deltek requires one on every report job). Set it once here and every Run Report uses it unless the action overrides it. Find it by scheduling a report in the UI (My Stuff > Reporting) and copying the QueueID, or ask a Vantagepoint administrator; it is the same value for all reports in your system.

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **Deltek Vantagepoint**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field            | Required                 | What to enter                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------ | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Vantagepoint URL         | Yes                      | The base API URL for your Vantagepoint instance, e.g. <https://customer1.deltek.com/vantagepointpod1/api>.                                                                                                                                                                                                                                                               |
| Database                 | Yes                      | The Vantagepoint database to log into, shown in the Database Name field of the API Authorization form used to generate the secret.                                                                                                                                                                                                                                       |
| Consumer Key (Client ID) | Yes                      | The Consumer Key from Vantagepoint's API Authorization form.                                                                                                                                                                                                                                                                                                             |
| Consumer Secret          | Yes                      | The secret generated from the Consumer Key on the API Authorization form (Actions > Generate Secret). Regenerating it breaks every connection using the old secret until they are reconnected.                                                                                                                                                                           |
| Username                 | Yes                      | A Vantagepoint user name to authenticate the API session as.                                                                                                                                                                                                                                                                                                             |
| Password                 | Yes                      | The password for the Vantagepoint user above.                                                                                                                                                                                                                                                                                                                            |
| Default Process Queue    | Optional / as applicable | Optional. The Vantagepoint Process Queue that reports run on (Deltek requires one on every report job). Set it once here and every Run Report uses it unless the action overrides it. Find it by scheduling a report in the UI (My Stuff > Reporting) and copying the QueueID, or ask a Vantagepoint administrator; it is the same value for all reports in your system. |

#### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

### Use an action

1. Add the required **Deltek Vantagepoint** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

### Actions

#### Run Report

Run a Vantagepoint report and get back the generated file.

**Inputs**

| Field                         | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------------------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Report                        | string          | Yes      | The Vantagepoint report to run.                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| File format                   | select (string) | No       | The format Vantagepoint generates the report in. These are the formats the Vantagepoint API documents. To use another format the Vantagepoint UI offers (Word, Excel, CSV, TIFF), schedule the report in the UI with that format and paste its Get Parameters payload into 'report parameters' -- the format in that payload is used as-is. Available values: PDF, XML. Default: PDF.                                                                                |
| Report parameters             | textarea        | No       | Leave blank to run the report with its saved defaults. Reports whose layout is built from the options you select usually need this: paste the ENTIRE JSON body Vantagepoint POSTs when you run the report from the UI (My Stuff > Reporting > schedule the report > Get Parameters, or dev-tools > Network > the 'processMasterJob' request payload). Copy it verbatim, including QueueID and FW\_DETAILJOBS; the keys inside ReportOptions differ for every report. |
| Wait for the report to finish | boolean         | No       | Poll until the report file is ready (up to 10 minutes) instead of returning immediately. Default: true.                                                                                                                                                                                                                                                                                                                                                              |
| Process Queue                 | string          | No       | The Vantagepoint Process Queue to run the report on. Deltek requires this on every report job. Leave blank to use the connection's Default Process Queue; set it here only to override that for this run. Find the value by scheduling the report once in the UI (My Stuff > Reporting) and copying the 'QueueID'.                                                                                                                                                   |

**Outputs**

| Field           | Type   | Description                                                |
| --------------- | ------ | ---------------------------------------------------------- |
| Status          | string | Job status.                                                |
| Process ID      | string | The report job id.                                         |
| File ID         | string | Generated file id (when completed).                        |
| Report file URL | string | Downloadable URL of the generated report (when completed). |
| Details         | string | Success or failure detail from Vantagepoint.               |

#### Get Report Status

Check whether a running report has finished and get its file id.

**Inputs**

| Field      | Type   | Required | Description                        |
| ---------- | ------ | -------- | ---------------------------------- |
| Process ID | string | Yes      | The report job id from Run Report. |

**Outputs**

| Field    | Type    | Description                         |
| -------- | ------- | ----------------------------------- |
| Status   | string  | Job status.                         |
| Complete | boolean | Whether the report finished.        |
| File ID  | string  | Generated file id (when completed). |
| Details  | string  | Success or failure detail.          |

#### Download Report File

Download a generated report file by its file id.

**Inputs**

| Field   | Type   | Required | Description                   |
| ------- | ------ | -------- | ----------------------------- |
| File ID | string | Yes      | The generated report file id. |

**Outputs**

| Field           | Type   | Description                          |
| --------------- | ------ | ------------------------------------ |
| Report file URL | string | Downloadable URL of the report file. |
| File name       | string | The report file name.                |

#### List Projects

List projects, optionally filtered by project number.

**Inputs**

| Field        | Type    | Required | Description                                        |
| ------------ | ------- | -------- | -------------------------------------------------- |
| Search       | string  | No       | Filter by project number.                          |
| Columns      | string  | No       | Comma-separated columns to return (advanced).      |
| Max results  | integer | No       | Maximum number of projects to return. Default: 50. |
| Start offset | integer | No       | Zero-based record offset to resume paging.         |

**Outputs**

| Field       | Type        | Description                                    |
| ----------- | ----------- | ---------------------------------------------- |
| Records     | dict\_array | The list of matching project records.          |
| Next offset | integer     | Offset to fetch the next page, if more remain. |

#### List Employees

List employees, optionally filtered by last name.

**Inputs**

| Field        | Type    | Required | Description                                         |
| ------------ | ------- | -------- | --------------------------------------------------- |
| Search       | string  | No       | Filter by employee last name.                       |
| Columns      | string  | No       | Comma-separated columns to return (advanced).       |
| Max results  | integer | No       | Maximum number of employees to return. Default: 50. |
| Start offset | integer | No       | Zero-based record offset to resume paging.          |

**Outputs**

| Field       | Type        | Description                                    |
| ----------- | ----------- | ---------------------------------------------- |
| Records     | dict\_array | The list of matching employee records.         |
| Next offset | integer     | Offset to fetch the next page, if more remain. |

#### List Firms

List firms (clients, vendors, and other companies), optionally filtered.

**Inputs**

| Field        | Type    | Required | Description                                     |
| ------------ | ------- | -------- | ----------------------------------------------- |
| Search       | string  | No       | Filter by firm name.                            |
| Columns      | string  | No       | Comma-separated columns to return (advanced).   |
| Max results  | integer | No       | Maximum number of firms to return. Default: 50. |
| Start offset | integer | No       | Zero-based record offset to resume paging.      |

**Outputs**

| Field       | Type        | Description                                    |
| ----------- | ----------- | ---------------------------------------------- |
| Records     | dict\_array | The list of matching firm records.             |
| Next offset | integer     | Offset to fetch the next page, if more remain. |

#### List Contacts

List contacts, optionally filtered by last name.

**Inputs**

| Field        | Type    | Required | Description                                        |
| ------------ | ------- | -------- | -------------------------------------------------- |
| Search       | string  | No       | Filter by contact last name.                       |
| Columns      | string  | No       | Comma-separated columns to return (advanced).      |
| Max results  | integer | No       | Maximum number of contacts to return. Default: 50. |
| Start offset | integer | No       | Zero-based record offset to resume paging.         |

**Outputs**

| Field       | Type        | Description                                    |
| ----------- | ----------- | ---------------------------------------------- |
| Records     | dict\_array | The list of matching contact records.          |
| Next offset | integer     | Offset to fetch the next page, if more remain. |

#### Create Employee

Add a new employee to the Employees hub.

**Inputs**

| Field             | Type     | Required | Description                                                                                                                                                                   |
| ----------------- | -------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Employee number   | string   | No       | Leave blank to let Vantagepoint assign the next number. Set it only if your system has auto numbering turned off for the Employees hub, or you were told which number to use. |
| First name        | string   | No       | Employee first name.                                                                                                                                                          |
| Last name         | string   | No       | Employee last name.                                                                                                                                                           |
| Email             | string   | No       | Employee email address.                                                                                                                                                       |
| Additional fields | textarea | No       | Extra employee fields as a JSON object (advanced).                                                                                                                            |

**Outputs**

| Field           | Type   | Description                                           |
| --------------- | ------ | ----------------------------------------------------- |
| Employee number | string | The number Vantagepoint assigned to the new employee. |
| Employee record | object | The created employee record.                          |

#### Update Employee

Change the details of an employee who already exists.

**Inputs**

| Field             | Type     | Required | Description                                                                                    |
| ----------------- | -------- | -------- | ---------------------------------------------------------------------------------------------- |
| Employee number   | string   | Yes      | The number of the employee to update.                                                          |
| Employee company  | string   | No       | Only needed in a multi-company database, where it identifies which company's record to update. |
| First name        | string   | No       | Employee first name.                                                                           |
| Last name         | string   | No       | Employee last name.                                                                            |
| Email             | string   | No       | Employee email address.                                                                        |
| Additional fields | textarea | No       | Extra employee fields as a JSON object (advanced).                                             |

**Outputs**

| Field           | Type   | Description                    |
| --------------- | ------ | ------------------------------ |
| Employee number | string | The updated employee's number. |
| Employee record | object | The updated employee record.   |

#### Get Invoice Labor Detail

Get the invoice labor transaction detail for a project's interactive billing.

**Inputs**

| Field             | Type   | Required | Description                                 |
| ----------------- | ------ | -------- | ------------------------------------------- |
| Project (WBS) key | string | Yes      | The top-level project identifier (WBS key). |

**Outputs**

| Field        | Type        | Description                    |
| ------------ | ----------- | ------------------------------ |
| Labor detail | dict\_array | The invoice labor detail rows. |

### Triggers

A trigger starts a workflow when its configured event occurs. Configure the event and filters before enabling the trigger.

#### On Employee Created

Trigger a workflow whenever a new employee record is added to the Deltek Vantagepoint Employees hub.

No setup is needed in Vantagepoint. This trigger checks the Employees hub every five minutes and starts one run per employee created after the trigger was turned on. Employees that already existed are never replayed.

**Event inputs**

| Field            | Type   | Required | Description                                                       |
| ---------------- | ------ | -------- | ----------------------------------------------------------------- |
| Employee Number  | string | Yes      | The new employee's number.                                        |
| Employee Company | string | No       | The company the employee belongs to, in a multi-company database. |
| Full Name        | string | No       | The new employee's first and last name.                           |
| Created          | string | No       | When the employee record was created.                             |
| Employee         | object | Yes      | The full Employee hub record.                                     |

**Outputs**

| Field            | Type   | Description                             |
| ---------------- | ------ | --------------------------------------- |
| Employee Number  | string | The new employee's number.              |
| Employee Company | string | The company the employee belongs to.    |
| Full Name        | string | The new employee's first and last name. |
| Created          | string | When the employee record was created.   |
| Employee         | dict   | The full Employee hub record.           |

#### On Project Created

Trigger a workflow whenever a new project is added to the Deltek Vantagepoint Projects hub. Fires once per project, not per phase or task.

No setup is needed in Vantagepoint. This trigger checks the Projects hub every five minutes and starts one run per project created after the trigger was turned on. Projects that already existed are never replayed, and phases and tasks added under a project do not start a run. It fires for every new project, including pursuits and overhead and promotional projects. Branch on the Charge Type, Status, or Stage outputs to narrow that down. Reading projects requires the Accounting module in Vantagepoint.

**Event inputs**

| Field          | Type   | Required | Description                                    |
| -------------- | ------ | -------- | ---------------------------------------------- |
| Project Number | string | Yes      | The new project's number.                      |
| Name           | string | No       | The new project's name.                        |
| Charge Type    | string | No       | Regular, Overhead, or Promotional.             |
| Status         | string | No       | Active, Dormant, or Inactive.                  |
| Stage          | string | No       | The project's pipeline stage, when it has one. |
| Created        | string | No       | When the project record was created.           |
| Project        | object | Yes      | The full Projects hub record.                  |

**Outputs**

| Field          | Type   | Description                                    |
| -------------- | ------ | ---------------------------------------------- |
| Project Number | string | The new project's number.                      |
| Name           | string | The new project's name.                        |
| Charge Type    | string | Regular, Overhead, or Promotional.             |
| Status         | string | Active, Dormant, or Inactive.                  |
| Stage          | string | The project's pipeline stage, when it has one. |
| Created        | string | When the project record was created.           |
| Project        | dict   | The full Projects hub record.                  |

### Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/deltek-vantagepoint.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
