---
title: "Create expense artifact"
method: POST
path: "/expense_lines/{expense_line_id}/expense_artifacts"
tags: ["ExpenseArtifact"]
---

# Create expense artifact

`POST /expense_lines/{expense_line_id}/expense_artifacts`

## Request

- Base URL: `https://dashmaster24-4.coupadev.com/api`
- URL: `https://dashmaster24-4.coupadev.com/api/expense_lines/{expense_line_id}/expense_artifacts`
- Auth: API key in header `X-COUPA-API-KEY`
- TypeScript: <https://skmtc.dev/coupa/apis/coupa-api-3/docs/expense_lines/:expense_line_id/expense_artifacts/post.ts> (a function with typed inputs; its response is checked against the schema)

Create expense artifact

## Path parameters

- `expense_line_id` integer, required

## Query parameters

- `return_object` 'limited' | 'shallow' | 'none'
- `filter` string

## Request body

- ExpenseArtifact
  - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `created-by` UserSimple
    - `account-security-type` integer: account_security_type
    - `active` boolean: A false value will inactivate the account making it no longer available to users. A true value will make it active and available to users.
    - `aic-user` boolean: Does the user have an AI Classification License?
    - `analytics-user` boolean: Does the user have an Analytics License?
    - `api-user` boolean: Is an API User?
    - `authentication-method` string, string(255): What Authentication Method will be used (Coupa_Credentials, LDAP, SAML)?
    - `avatar-thumb-url` string, string: Avatar url
    - `business-function` string, string(255): The employee's main job role in your company, e.g. Sales, Executive, Administrative, Managerial, etc.
    - `business-group-security-type` integer: business_group_security_type
    - `ccw-user` boolean: Does the user have a Contingent Workforce License?
    - `contracts-user` boolean: Does the user have a Contracts License?
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `default-locale` string, string(10): Default locale
    - `edit-invoice-on-quick-entry` boolean: Edit invoice button routes user to fast entry screen
    - `email` string, string(255), required: email
    - `employee-number` string, string(255): employee number
    - `expense-user` boolean: Does the user have a Expense License?
    - `firstname` string, string(40), required: first name
    - `fullname` string, string(255): full name
    - `generate-password-and-notify` 'Yes' | 'No', string: Set to Yes if you want the system to invite the user to the system and have them set up their password
    - `id` integer: Coupa unique identifier
    - `inventory-user` boolean: Does the user have a Inventory License?
    - `lastname` string, string(40), required: last name
    - `login` string, string(255), required: login
    - `mention-name` string, string(255): Mention Name
    - `password` string, string: Changed password
    - `purchasing-user` boolean: Does the user have a Purchasing License?
    - `salesforce-enabled` boolean: salesforce_enabled
    - `salesforce-id` string, string(255), required: salesforce_id
    - `seniority-level` string, string(255): The employee's job grade or band in your company's hierarchy.
    - `sourcing-user` boolean: Does the user have a Sourcing License?
    - `spend-guard-user` boolean: Does the user have a Spend Guard License?
    - `sso-identifier` string, string(255): User's Single Sign-on ID (SSO ID)
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `external-src-ref` string, string(255): External system's unique identifier for transaction
  - `id` integer: Coupa unique identifier
  - `image-content-type` string, string(255): image_content_type
  - `image-file-name` string, string(255): image_file_name
  - `image-file-size` string, string(255): image_file_size
  - `ocr-status` string, string(50): OCR Status
  - `source-content-type` string, string(255): source_content_type
  - `source-file-name` string, string(255): source_file_name
  - `source-file-size` string, string(255): source_file_size
  - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `updated-by` UserSimple
    - `account-security-type` integer: account_security_type
    - `active` boolean: A false value will inactivate the account making it no longer available to users. A true value will make it active and available to users.
    - `aic-user` boolean: Does the user have an AI Classification License?
    - `analytics-user` boolean: Does the user have an Analytics License?
    - `api-user` boolean: Is an API User?
    - `authentication-method` string, string(255): What Authentication Method will be used (Coupa_Credentials, LDAP, SAML)?
    - `avatar-thumb-url` string, string: Avatar url
    - `business-function` string, string(255): The employee's main job role in your company, e.g. Sales, Executive, Administrative, Managerial, etc.
    - `business-group-security-type` integer: business_group_security_type
    - `ccw-user` boolean: Does the user have a Contingent Workforce License?
    - `contracts-user` boolean: Does the user have a Contracts License?
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `default-locale` string, string(10): Default locale
    - `edit-invoice-on-quick-entry` boolean: Edit invoice button routes user to fast entry screen
    - `email` string, string(255), required: email
    - `employee-number` string, string(255): employee number
    - `expense-user` boolean: Does the user have a Expense License?
    - `firstname` string, string(40), required: first name
    - `fullname` string, string(255): full name
    - `generate-password-and-notify` 'Yes' | 'No', string: Set to Yes if you want the system to invite the user to the system and have them set up their password
    - `id` integer: Coupa unique identifier
    - `inventory-user` boolean: Does the user have a Inventory License?
    - `lastname` string, string(40), required: last name
    - `login` string, string(255), required: login
    - `mention-name` string, string(255): Mention Name
    - `password` string, string: Changed password
    - `purchasing-user` boolean: Does the user have a Purchasing License?
    - `salesforce-enabled` boolean: salesforce_enabled
    - `salesforce-id` string, string(255), required: salesforce_id
    - `seniority-level` string, string(255): The employee's job grade or band in your company's hierarchy.
    - `sourcing-user` boolean: Does the user have a Sourcing License?
    - `spend-guard-user` boolean: Does the user have a Spend Guard License?
    - `sso-identifier` string, string(255): User's Single Sign-on ID (SSO ID)
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `url` string, string: External link to artifact

## Response `201`

Created

- ExpenseArtifact
  - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `created-by` UserSimple
    - `account-security-type` integer: account_security_type
    - `active` boolean: A false value will inactivate the account making it no longer available to users. A true value will make it active and available to users.
    - `aic-user` boolean: Does the user have an AI Classification License?
    - `analytics-user` boolean: Does the user have an Analytics License?
    - `api-user` boolean: Is an API User?
    - `authentication-method` string, string(255): What Authentication Method will be used (Coupa_Credentials, LDAP, SAML)?
    - `avatar-thumb-url` string, string: Avatar url
    - `business-function` string, string(255): The employee's main job role in your company, e.g. Sales, Executive, Administrative, Managerial, etc.
    - `business-group-security-type` integer: business_group_security_type
    - `ccw-user` boolean: Does the user have a Contingent Workforce License?
    - `contracts-user` boolean: Does the user have a Contracts License?
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `default-locale` string, string(10): Default locale
    - `edit-invoice-on-quick-entry` boolean: Edit invoice button routes user to fast entry screen
    - `email` string, string(255), required: email
    - `employee-number` string, string(255): employee number
    - `expense-user` boolean: Does the user have a Expense License?
    - `firstname` string, string(40), required: first name
    - `fullname` string, string(255): full name
    - `generate-password-and-notify` 'Yes' | 'No', string: Set to Yes if you want the system to invite the user to the system and have them set up their password
    - `id` integer: Coupa unique identifier
    - `inventory-user` boolean: Does the user have a Inventory License?
    - `lastname` string, string(40), required: last name
    - `login` string, string(255), required: login
    - `mention-name` string, string(255): Mention Name
    - `password` string, string: Changed password
    - `purchasing-user` boolean: Does the user have a Purchasing License?
    - `salesforce-enabled` boolean: salesforce_enabled
    - `salesforce-id` string, string(255), required: salesforce_id
    - `seniority-level` string, string(255): The employee's job grade or band in your company's hierarchy.
    - `sourcing-user` boolean: Does the user have a Sourcing License?
    - `spend-guard-user` boolean: Does the user have a Spend Guard License?
    - `sso-identifier` string, string(255): User's Single Sign-on ID (SSO ID)
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `external-src-ref` string, string(255): External system's unique identifier for transaction
  - `id` integer: Coupa unique identifier
  - `image-content-type` string, string(255): image_content_type
  - `image-file-name` string, string(255): image_file_name
  - `image-file-size` string, string(255): image_file_size
  - `ocr-status` string, string(50): OCR Status
  - `source-content-type` string, string(255): source_content_type
  - `source-file-name` string, string(255): source_file_name
  - `source-file-size` string, string(255): source_file_size
  - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `updated-by` UserSimple
    - `account-security-type` integer: account_security_type
    - `active` boolean: A false value will inactivate the account making it no longer available to users. A true value will make it active and available to users.
    - `aic-user` boolean: Does the user have an AI Classification License?
    - `analytics-user` boolean: Does the user have an Analytics License?
    - `api-user` boolean: Is an API User?
    - `authentication-method` string, string(255): What Authentication Method will be used (Coupa_Credentials, LDAP, SAML)?
    - `avatar-thumb-url` string, string: Avatar url
    - `business-function` string, string(255): The employee's main job role in your company, e.g. Sales, Executive, Administrative, Managerial, etc.
    - `business-group-security-type` integer: business_group_security_type
    - `ccw-user` boolean: Does the user have a Contingent Workforce License?
    - `contracts-user` boolean: Does the user have a Contracts License?
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `default-locale` string, string(10): Default locale
    - `edit-invoice-on-quick-entry` boolean: Edit invoice button routes user to fast entry screen
    - `email` string, string(255), required: email
    - `employee-number` string, string(255): employee number
    - `expense-user` boolean: Does the user have a Expense License?
    - `firstname` string, string(40), required: first name
    - `fullname` string, string(255): full name
    - `generate-password-and-notify` 'Yes' | 'No', string: Set to Yes if you want the system to invite the user to the system and have them set up their password
    - `id` integer: Coupa unique identifier
    - `inventory-user` boolean: Does the user have a Inventory License?
    - `lastname` string, string(40), required: last name
    - `login` string, string(255), required: login
    - `mention-name` string, string(255): Mention Name
    - `password` string, string: Changed password
    - `purchasing-user` boolean: Does the user have a Purchasing License?
    - `salesforce-enabled` boolean: salesforce_enabled
    - `salesforce-id` string, string(255), required: salesforce_id
    - `seniority-level` string, string(255): The employee's job grade or band in your company's hierarchy.
    - `sourcing-user` boolean: Does the user have a Sourcing License?
    - `spend-guard-user` boolean: Does the user have a Spend Guard License?
    - `sso-identifier` string, string(255): User's Single Sign-on ID (SSO ID)
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `url` string, string: External link to artifact

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/coupa/apis/coupa-api-3.md) - [All operations](https://skmtc.dev/coupa/apis/coupa-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/coupa/apis/coupa-api-3/revisions/3919beaf1876?raw)