> ## Documentation Index > Fetch the complete documentation index at: https://docs.zapier.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a stored action > Create Stored Action Creates a new stored action entry that can then be executed from a simpler call to /stored-actions with just the stored action `id`. This will not execute a StoredAction. This is an async process and will only respond with the id of the stored action and other meta data, and it is the callers responsibility to poll GET /stored-actions/{stored_action_id}/runs/{run_id} with the run id returned from POST /stored-actions/{stored_action_id}/run to fetch the results after executing a stored action. The triple (selected_api, action_type, action_key) is required to create a stored action. Only core actions are supported; external and custom (App Extension) actions cannot be created as stored actions via this endpoint. **Note on `connection_id`:** Other Zapier APIs may expose the same identifier under the field name `authentication_id`. The value is the same UUID — pass it here under the `connection_id` key. ## OpenAPI ````yaml /api-reference/specs/actions.yaml post /actions/v1/stored-actions openapi: 3.1.0 info: title: Actions API description: >- Public access to Zapier Stored Actions and the runs that execute them — create, list, retrieve, update, and delete stored actions; trigger runs and fetch run results. version: v1 contact: url: https://docs.zapier.com servers: - url: https://api.zapier.com description: Production security: - OAuth: [] tags: - name: Stored Actions description: Operations related to a Stored Action paths: /actions/v1/stored-actions: post: tags: - Stored Actions summary: Create a stored action description: >- Create Stored Action Creates a new stored action entry that can then be executed from a simpler call to /stored-actions with just the stored action `id`. This will not execute a StoredAction. This is an async process and will only respond with the id of the stored action and other meta data, and it is the callers responsibility to poll GET /stored-actions/{stored_action_id}/runs/{run_id} with the run id returned from POST /stored-actions/{stored_action_id}/run to fetch the results after executing a stored action. The triple (selected_api, action_type, action_key) is required to create a stored action. Only core actions are supported; external and custom (App Extension) actions cannot be created as stored actions via this endpoint. **Note on `connection_id`:** Other Zapier APIs may expose the same identifier under the field name `authentication_id`. The value is the same UUID — pass it here under the `connection_id` key. operationId: createStoredAction requestBody: content: application/json: schema: $ref: '#/components/schemas/StoredActionsCreateRequest' examples: ExamplePOSTRequest: value: data: connection_id: 019320ab-0000-7000-8000-abcdef012345 selected_api: SplitwiseCLIAPI@1.0.0 action_key: new_contact action_type: read inputs: first_name: John last_name: Doe summary: Example POST Request required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/StoredActionsCreateResponse' examples: Success: value: type: stored_action id: 123e4567-e89b-12d3-a456-426614174000 description: A StoredAction record was successfully created. headers: X-RateLimit-Limit: schema: type: integer description: >- Effective request cap per 300-second window. Default: 200. Maximum via limit_override: 1000. X-RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. X-RateLimit-Reset: schema: type: string format: date-time description: Unix timestamp when the current 300-second window resets. '400': content: application/json: schema: $ref: '#/components/schemas/ActionsErrorResponse' examples: BadRequest: value: errors: - status: 400 code: bad_request title: Bad Request detail: Improperly formatted or incompleted request source: null meta: {} summary: Bad Request description: Indicates an error creating a StoredAction record. headers: X-RateLimit-Limit: schema: type: integer description: >- Effective request cap per 300-second window. Default: 200. Maximum via limit_override: 1000. X-RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. X-RateLimit-Reset: schema: type: string format: date-time description: Unix timestamp when the current 300-second window resets. '403': content: application/json: schema: $ref: '#/components/schemas/ActionsErrorResponse' examples: PermissionDenied: value: errors: - status: 403 code: permission_denied detail: >- User does not have enough permissions to perform action summary: Permission Denied description: Permission denied. Unauthorized request. '429': content: application/json: schema: $ref: '#/components/schemas/ActionsErrorResponse' examples: TooManyRequests: value: errors: - status: 429 code: too_many_requests detail: Rate limit exceeded. Too many requests. summary: Too Many Requests description: Too many requests. headers: X-RateLimit-Limit: schema: type: integer description: >- Effective request cap per 300-second window. Default: 200. Maximum via limit_override: 1000. X-RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. X-RateLimit-Reset: schema: type: string format: date-time description: Unix timestamp when the current 300-second window resets. Retry-After: schema: type: integer description: Seconds to wait before retrying. required: true '500': content: application/json: schema: $ref: '#/components/schemas/ActionsErrorResponse' examples: UnhandledOrExternalServiceError: value: errors: - status: 500 code: external_service_error detail: An error occurred with an external service. summary: Unhandled or External Service Error description: Internal Server Error headers: X-RateLimit-Limit: schema: type: integer description: >- Effective request cap per 300-second window. Default: 200. Maximum via limit_override: 1000. X-RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. X-RateLimit-Reset: schema: type: string format: date-time description: Unix timestamp when the current 300-second window resets. '503': content: application/json: schema: $ref: '#/components/schemas/ActionsErrorResponse' examples: ServiceUnavailableError: value: errors: - status: 503 code: service_unavaiable detail: Service is temporarily unavailable summary: Service Unavailable Error description: Service Unavailable headers: X-RateLimit-Limit: schema: type: integer description: >- Effective request cap per 300-second window. Default: 200. Maximum via limit_override: 1000. X-RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. X-RateLimit-Reset: schema: type: string format: date-time description: Unix timestamp when the current 300-second window resets. Retry-After: schema: type: integer description: Seconds to wait before retrying. required: true security: - OAuth: - external components: schemas: StoredActionsCreateRequest: type: object properties: data: $ref: '#/components/schemas/StoredActionsCreateRequestParams' required: - data StoredActionsCreateResponse: type: object description: The response returned from creating a Stored Action record. properties: type: type: string default: stored_action description: >- Specifies the resource type, as required by the JSON:API specification. id: type: string format: uuid description: >- The UUID id that identifies this stored action and can be used to execute the stored procedure by calling the POST /stored-actions/{stored_action_id}/run endpoint. required: - id ActionsErrorResponse: type: object properties: errors: type: array items: $ref: '#/components/schemas/ActionsError' description: An array of error objects. required: - errors StoredActionsCreateRequestParams: type: object description: |- The shape of the payload that must be sent to create a Stored Action. Only the triple (selected_api, action_type, action_key) is accepted — `action_id` is intentionally not exposed on this endpoint. properties: connection_id: type: string format: uuid description: >- UUID of the connection to use when executing the Stored Action. Can be any connection visible to the user (including shared). selected_api: type: string description: >- Something like `SlackAPI` (for Python apps) or `SplitwiseCLIAPI@1.0.0` (for CLI apps). Non-public apps are fine as long as the authed user can access them. If a version is included we attempt to use that version of the integration. If no version is provided we attempt to use the latest version of the integration action_key: type: string description: Name of the action in the integration. Such as `new_contact`. action_type: allOf: - $ref: '#/components/schemas/ActionTypeEnum' description: >- Specifies the type of action in the integration since some integrations could have similarly named actions with different actions types * `read` - Read * `read_bulk` - Read Bulk * `write` - Write * `run` - Run * `search` - Search * `search_or_write` - Search Or Write * `search_and_write` - Search And Write * `filter` - Filter inputs: default: {} description: >- Object that matches the input the action would normally get. Has all the same keys/types as the `input` of the action. (Formerly known as "needs" in some documentation) required: - action_key - action_type - selected_api ActionsError: type: object description: Base Error definition properties: status: type: integer description: The HTTP status code applicable to this problem. code: type: string description: A unique identifier for this particular occurrence of the problem. title: type: string description: A short summary of the problem. detail: type: string description: >- A human-readable explanation specific to this occurrence of the problem. source: oneOf: - $ref: '#/components/schemas/ActionsErrorSource' - type: 'null' description: An object containing references to the primary source of the error. meta: type: - object - 'null' additionalProperties: {} description: Any additional metadata about the error. ActionTypeEnum: enum: - read - read_bulk - write - run - search - search_or_write - search_and_write - filter type: string description: |- * `read` - Read * `read_bulk` - Read Bulk * `write` - Write * `run` - Run * `search` - Search * `search_or_write` - Search Or Write * `search_and_write` - Search And Write * `filter` - Filter ActionsErrorSource: type: object description: Populates the `source` object inside our error responses. properties: pointer: type: string description: >- Pointer to the value in the request document that caused the error e.g. `/actions`. parameter: type: string description: A string indicating which URI query parameter caused the error. header: type: string description: >- A string indicating the name of a single request header which caused the error. securitySchemes: OAuth: type: oauth2 description: OAuth 2.0 authentication. flows: authorizationCode: authorizationUrl: https://zapier.com/oauth/authorize tokenUrl: https://zapier.com/oauth/token scopes: external: Scope that gives access to all Public APIs clientCredentials: tokenUrl: https://zapier.com/oauth/token scopes: external: Scope that gives access to all Public APIs ````