# `smallforce integrations custom import`

Import an OpenAPI document from a public HTTPS URL

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.11. Run `smallforce integrations custom import --help` locally to view the same reference for your installed version.

## Complete command help

```text
Usage: smallforce integrations custom import [options] <url>

Import an OpenAPI document from a public HTTPS URL

Options:
  --slug <slug>                 Unique integration slug, for example inventory
  --spec-format <format>        Specification format; currently openapi (default: "openapi")
  --name <name>                 Display name; defaults to the spec title
  --description <text>          Description; defaults to the spec description
  --alias <names...>            Alternative names used in tool discovery
  --use-case <descriptions...>  Workflows used in tool discovery
  --api-key <key>               SmallForce API key, or set SMALLFORCE_API_KEY
  --backend-url <url>           SmallForce backend URL, or set SMALLFORCE_BACKEND_URL
  --json                        Print stable machine-readable JSON
  --text                        Print human-readable text
  --format <format>             Output format: text or json
  -h, --help                    display help for command
```

## Related reference

- [`smallforce integrations custom`](/docs/cli/commands/integrations/custom): Parent command and related operations.
- [CLI installation and authentication](/docs/cli/getting-started): Install the CLI and configure an API key.
- [CLI JSON output](/docs/cli/json-output): Use stable machine-readable output in scripts and agents.