View as Markdown
Drata icon

Drata ACTION

Create Vendor

Create a new Vendor. See the documentation.
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Drata account once, then configure and run Create Vendor from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "drata-create-vendor",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    drata: { authProvisionId: "apn_xxxxxxx" },
    name: "Name",
    category: "Category",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Vendor inputs
Property Type Description
name Name string
The name of the vendor
Required
category Category string
The type of vendor
Required
risk Risk string
The level of risk for customer data
Required
critical Critical boolean
Is this vendor is considered critical
Required
isSubProcessor Is Sub Processor boolean
Is this vendor is considered sub-processor
Required
isSubProcessorActive Is Sub Processor Active boolean
Is the subprocessor active
Required
userId User ID integer
The user ID of the person responsible for the compliance of this vendor
Required Dynamic
url URL string
The URL of the vendor
Required
privacyUrl Privacy URL string
Vendor Privacy Policy URL
Required
termsUrl Terms URL string
Vendor Terms of Use URL
Required
servicesProvided Services Provided string
Describe vendor services
Required
dataStored Data Stored string
What type of data the vendor stores
Required
location Location string
The vendor location
Required
hasPii Has PII boolean
Does this vendor store any type of PII
Required
passwordPolicy Password Policy string
The vendor password policy
Required
passwordRequiresMinLength Password Requires Min Length boolean
Is there a minimum length for user passwords
Required
passwordRequiresNumber Password Requires Number boolean
Does a password require numbers
Required
passwordRequiresSymbol Password Requires Symbol boolean
Does a password require non-alpha-numeric characters
Required
passwordMfaEnabled Password MFA Enabled boolean
Is mult-factor authentication enabled for this vendor
Required
accountManagerName Account Manager Name string
The name of the corresponding account manager for this vendor
Required
accountManagerEmail Account Manager Email string
The email of the corresponding account manager for this vendor
Required
isComplianceReviewRequired Is Compliance Review Required boolean
Is vendor compliance report review required?
Required
passwordMinLength Password Min Length integer
Minimum character length for a password
Optional
renewalDate Renewal Date string
Vendor renewal ISO 8601 datetime. E.g. 2021-01-01T00:00:00.000Z
Optional
renewalScheduleType Renewal Schedule Type string
Vendor renewal schedule type
Optional
notes Notes string
Additional notes for vendor
Optional
confirmed Confirmed boolean
Is all vendor data confirmed?
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
drata-create-vendor
Version
0.0.4
App
Drata
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes