---

name: veeva-deploy-integration description: 'Veeva Vault deploy integration for REST API and clinical operations.

Use when working with Veeva Vault document management and CRM.

Trigger: "veeva deploy integration".

' allowed-tools: Read, Write, Edit, Grep version: 1.0.0 license: MIT author: Jeremy Longshore jeremy@intentsolutions.io tags:

• saas
• life-sciences
• crm
• veeva compatibility: Designed for Claude Code

---

Veeva Vault Deploy Integration

Overview

Guidance for deploy integration with Veeva Vault REST API, VQL queries, and VAPIL Java SDK.

Instructions

Key Vault API Concepts

• Authentication: Session-based (username/password or OAuth 2.0)
• Base URL: https://{vault}.veevavault.com/api/v24.1/
• VQL: SQL-like query language for Vault data
• VAPIL: Open-source Java SDK covering all Platform APIs
• Lifecycle: Documents flow through states (Draft > In Review > Approved)

Common VQL Patterns

-- List documents by type
SELECT id, name__v FROM documents WHERE type__v = 'Trial Document'

-- Find objects
SELECT id, name__v FROM site__v WHERE status__v = 'active__v'

-- Join related objects
SELECT id, name__v, study__vr.name__v FROM study_country__v

Error Handling

| Error | Cause | Solution | |-------|-------|----------| | INVALID_SESSION_ID | Session expired | Re-authenticate | | INSUFFICIENT_ACCESS | Missing permissions | Check security profile | | INVALID_DATA | Bad VQL or field name | Validate against metadata | | OPERATION_NOT_ALLOWED | Lifecycle state conflict | Check document state |

Resources

• Vault API Reference
• VQL Reference
• VAPIL SDK
• Developer Portal

Next Steps

See related Veeva Vault skills for more patterns.