# Vendr

> Look up software products and pricing, manage purchase scopes and webhooks, and work with negotiations and contract analyses.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/vendr

## Actions

### Advanced Price Estimate

Advanced Price Estimate. Returns the full service response for the connected account.

**Inputs**

- Scope ID (`scope_id`, text, required): ID of the scope to retrieve pricing for

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "currency": "example",
    "estimate": {
      "percentile10": 1,
      "percentile15": 1,
      "percentile20": 1,
      "percentile25": 1,
      "percentile30": 1,
      "percentile35": 1,
      "percentile40": 1,
      "percentile45": 1,
      "percentile50": 1,
      "percentile55": 1,
      "percentile60": 1,
      "percentile65": 1,
      "percentile70": 1,
      "percentile75": 1,
      "percentile80": 1,
      "percentile85": 1,
      "percentile90": 1
    },
    "productEstimates": [],
    "realPurchaseCount": [],
    "realSimilarPurchases": [],
    "timestamp": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Basic Price Estimate

Basic Price Estimate. Returns the full service response for the connected account.

**Inputs**

- Scope ID (`scope_id`, text, required): ID of the scope to retrieve pricing for

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "currency": "example",
    "estimate": {
      "percentile25": 1,
      "percentile50": 1,
      "percentile75": 1
    },
    "timestamp": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Chat with an agent

Chat with an agent.

**Inputs**: None.

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "id": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Create a Scope

Create a Scope.

**Inputs**

- Previous scope ID (`previous_scope_id`, text): Id of the previous scope this replaced
- Scope terms (`scope_terms`, list, required): Terms of purchase that apply to the whole scope
- Product terms (`product_terms`, list, required): Terms of purchase that apply to specific products, including the dimension values for each product

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "createdOn": "example",
    "documentProcessing": {
      "documentType": "order_form",
      "error": "example",
      "filename": "example",
      "mimeType": "example",
      "status": "pending",
      "updatedAt": "example"
    },
    "id": "example",
    "nextScopeId": "example",
    "previousScopeId": "example",
    "productTerms": [],
    "scopeTerms": [],
    "source": "manual"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Create a webhook

Create a webhook.

**Inputs**

- Url (`url`, text, required): url.
- Events (`events`, list, required): events. One or more of: `scope.extracted`, `negotiation.summary.updated`, `negotiation.escalation.created`, `negotiation.escalation.updated`.

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "events": [],
    "id": "example",
    "secret": "example",
    "url": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Create contract analysis

Create contract analysis.

**Inputs**

- Signed url (`signed_url`, text, required): signedUrl.

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Delete webhook

Delete webhook.

**Inputs**

- Webhook (`webhook_id`, text, required): The ID of the webhook

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "id": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get a Company

Get a Company. Returns the full service response for the connected account.

**Inputs**

- Company ID (`company_id`, text, required): ID of the company to retrieve

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "category": {
      "description": "example",
      "id": "example",
      "lastUpdatedAt": "example",
      "name": "example",
      "parentCategoryId": "example"
    },
    "competitors": [],
    "defaultPriceRange": {
      "currency": "example",
      "max": 1,
      "min": 1
    },
    "description": "example",
    "discontinued": true,
    "domain": "example",
    "fiscalYearEnd": "example",
    "icon": "example",
    "id": "example",
    "lastUpdatedAt": "example",
    "learningDataSamples": [],
    "legalName": "example",
    "name": "example",
    "productFamilies": [],
    "products": [],
    "realPurchaseCount": 1,
    "stockSymbols": [],
    "url": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get a contract analysis

Get a contract analysis. Returns the full service response for the connected account.

**Inputs**

- Contract analysis ID (`contract_analysis_id`, text, required): The ID of the contract analysis

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Get a Product

Get a Product. Returns the full service response for the connected account.

**Inputs**

- Product ID (`product_id`, text, required): ID of the product to retrieve

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "company": {
      "domain": "example",
      "id": "example",
      "legalName": "example",
      "name": "example"
    },
    "competitors": [],
    "currency": "example",
    "defaultPrice": 1,
    "description": "example",
    "icon": "example",
    "id": "example",
    "includedFeatures": [],
    "isCustomEstimateAvailable": true,
    "lastUpdatedAt": "example",
    "name": "example",
    "pricingDimensions": [],
    "productFamilyId": "example",
    "url": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get a Product Family

Get a Product Family. Returns the full service response for the connected account.

**Inputs**

- Product family ID (`product_family_id`, text, required): ID of the product family to retrieve

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "defaultPriceRange": {
      "currency": "example",
      "max": 1,
      "min": 1
    },
    "id": "example",
    "lastUpdatedAt": "example",
    "name": "example",
    "products": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get a Scope

Get a Scope. Returns the full service response for the connected account.

**Inputs**

- Scope ID (`scope_id`, text, required): ID of the scope to retrieve

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "createdOn": "example",
    "documentProcessing": {
      "documentType": "order_form",
      "error": "example",
      "filename": "example",
      "mimeType": "example",
      "status": "pending",
      "updatedAt": "example"
    },
    "id": "example",
    "nextScopeId": "example",
    "previousScopeId": "example",
    "productTerms": [],
    "scopeTerms": [],
    "source": "manual"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get escalation

Get escalation. Returns the full service response for the connected account.

**Inputs**

- Negotiation ID (`negotiation_id`, text, required): ID of the negotiation the escalation belongs to.
- Escalation ID (`escalation_id`, text, required): ID of the escalation to retrieve.

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "escalation": {
      "clarifications": [],
      "createdAt": "example",
      "escalationType": "clarification",
      "id": "example",
      "resolvedAt": "example",
      "status": "open"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get FAQs

Get FAQs. Returns the full service response for the connected account.

**Inputs**

- Company ID (`company_id`, text, required): Id of the company to retrieve negotiation insights for

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "faqs": [],
    "lastUpdatedAt": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get webhook event

Get webhook event. Returns the full service response for the connected account.

**Inputs**

- Webhook (`webhook_id`, text, required): The ID of the webhook
- Event ID (`event_id`, text, required): The ID of the webhook event

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "attempts": 1,
    "createdAt": "example",
    "data": {
      "body": {
        "data": {
          "errorMessage": "example",
          "scopeId": "example",
          "status": "completed"
        },
        "eventType": "scope.extracted"
      },
      "headers": {},
      "parsedQuery": {},
      "path": "example",
      "query": "example"
    },
    "id": "example",
    "lastAttemptAt": "example",
    "nextAttemptAt": "example",
    "responseStatus": 1,
    "status": "example",
    "successfulAt": "example",
    "updatedAt": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### List Categories

List Categories. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Limit (`limit`, number): Maximum number of categories to return. From 1 to 100.
- Offset (`offset`, number): Number of categories to skip. At least 0.
- Parent category ID (`parent_category_id`, text): Filter by parent category ID
- Sort by (`sort_by`, text): Field to sort by. One of: `name`.
- Sort order (`sort_order`, text): Sort order. One of: `asc`, `desc`.

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "limit": 1,
      "offset": 1,
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List Companies

List Companies. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Name (`name`, text): Filter by company name (partial match)
- Domain (`domain`, text): Filter by company domain
- Category ID (`category_id`, text): Filter by category ID
- Limit (`limit`, number): Maximum number of companies to return. From 1 to 100.
- Offset (`offset`, number): Number of companies to skip. At least 0.
- Sort by (`sort_by`, text): Field to sort by. One of: `name`.
- Sort order (`sort_order`, text): Sort order. One of: `asc`, `desc`.
- Ids (`ids`, list): A string of comma separated company ids.

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "limit": 1,
      "offset": 1,
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List escalations

List escalations. Returns the full service response for the connected account.

**Inputs**

- Negotiation ID (`negotiation_id`, text, required): ID of the negotiation to list escalations for.

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "escalations": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### List Product Families

List Product Families. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Company ID (`company_id`, text, required): ID of the company to retrieve
- Ids (`ids`, list): A string of comma separated product family ids.
- Limit (`limit`, number): Maximum number of companies to return. From 1 to 100.
- Offset (`offset`, number): Number of companies to skip. At least 0.
- Sort by (`sort_by`, text): Field to sort by. One of: `name`, `sortOrder`.
- Sort order (`sort_order`, text): Sort order. One of: `asc`, `desc`.

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "limit": 1,
      "offset": 1,
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List Products

List Products. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Company ID (`company_id`, text, required): ID of the company to retrieve
- Ids (`ids`, list): A string of comma separated product ids.
- Product family ID (`product_family_id`, text): ID of the product family to retrieve
- Limit (`limit`, number): Maximum number of companies to return. From 1 to 100.
- Offset (`offset`, number): Number of companies to skip. At least 0.
- Sort by (`sort_by`, text): Field to sort by. One of: `name`, `sortOrder`.
- Sort order (`sort_order`, text): Sort order. One of: `asc`, `desc`.

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "data": [],
    "pagination": {
      "limit": 1,
      "offset": 1,
      "total": 1
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### List webhook events

List webhook events. Returns the full service response for the connected account.

**Inputs**

- Webhook (`webhook_id`, text, required): The ID of the webhook

**Outputs**

- `data` (list): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": [],
  "has_more": false,
  "next_cursor": null
}
```

### List webhooks

List webhooks. Returns the full service response for the connected account.

**Inputs**: None.

**Outputs**

- `data` (list): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": [],
  "has_more": false,
  "next_cursor": null
}
```

### Negotiation summary

Negotiation summary. Returns the full service response for the connected account.

**Inputs**

- Negotiation ID (`negotiation_id`, text, required): ID of the negotiation you want a summary for.

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "createdAt": "example",
    "escalations": [],
    "executiveSummaries": [],
    "id": "example",
    "scope": {
      "additionalNotes": "example",
      "dealType": "new_purchase",
      "evaluatingAlternatives": true,
      "id": "example",
      "leverage": "example",
      "productIssues": "example",
      "renewalDate": "example",
      "requirements": "example",
      "targetPrice": 1,
      "targetSignDate": "example",
      "termInMonths": 1,
      "updatedAt": "example"
    },
    "status": "planning",
    "supplier": {
      "name": "example"
    },
    "updatedAt": "example",
    "url": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Post external update

Post external update.

**Inputs**

- Negotiation ID (`negotiation_id`, text, required): ID of the negotiation to post the external update to.
- Timestamp (`timestamp`, date and time, required): When the external entity was last updated.
- External ID (`external_id`, text, required): ID of the external entity.
- Source (`source`, text, required): Source of the external entity.
- Schema (`schema`, object, required): Additional structured schema. Use the documented fields.
- Payload (`payload`, object, required): Additional structured payload. Use the documented fields.

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Start negotiation

Start negotiation.

**Inputs**

- Metadata (`metadata`, object): Additional structured metadata. Use the documented fields.
- Supplier (`supplier`, object, required): Additional structured supplier. Use the documented fields.
- Participants (`participants`, list): Optional list of additional people involved in the deal beyond the primary contact, such as legal, security, or procurement, so they can be included on communications or internal routing.
- Contact email (`contact_email`, text, required): Email of the primary stakeholder on the buyer side, the main person Vendr should treat as owner of this negotiation for questions and updates.
- Contact name (`contact_name`, text, required): Full name of the primary buyer contact (paired with `contactEmail`).
- Engagement type (`engagement_type`, text, required): How your organization wants Vendr engaged on this opportunity. `vendr_led` means Vendr drives the negotiation workflow end to end. `strategy_only` means advisory or strategic support without Vendr acting as the full execution owner of the negotiation. One of: `vendr_led`, `strategy_only`.
- Scope (`scope`, object): Additional structured scope. Use the documented fields.
- File (`file`, object): Additional structured file. Use the documented fields.

**Outputs**

- `data` (object): Data.
- `has_more` (true/false): Has more.
- `next_cursor` (text): Next cursor.

**Example output**

```json
{
  "data": {
    "negotiationId": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```
