---
title: "Create a contact via URL parameters"
description: "Use URL parameters to pre-fill the OnePageCRM Add Contact form — useful for quick-add buttons in your own app or internal tools."
canonical_url: https://developer.onepagecrm.com/integrations/quick-create-contact-url/
source: Markdown mirror of https://developer.onepagecrm.com/integrations/quick-create-contact-url/
---

You can use URL parameters to pre-fill the **Add Contact** form in
your OnePageCRM account. Click the link and OnePageCRM opens on the
Add Contact page with the form already filled in.

For example, this URL adds Jane Doe to your contact list:

```
https://app.onepagecrm.com/add_new_contact?firstname=Jane&lastname=Doe&company=Acme%20Solar&tags[]=solar
```

Nothing is saved automatically — the user reviews the prefilled form,
edits if needed, and clicks save. They need to be signed in to
OnePageCRM.

## When to use this

This is a low-friction way to bridge your own app or internal tools
into OnePageCRM without writing a full integration. Useful for:

- Adding "Save to OnePageCRM" buttons next to records in your own
  database — your support team can save customers as contacts in one
  click.
- Bookmarklets for sales teams pulling contacts off other websites.
- Generated email signatures or invoice PDFs that include a
  one-click "save sender" link.

## Sample

| First name | Last name | Company    | |
| ---------- | --------- | ---------- | --- |
| Jane       | Doe       | Acme Solar | [Add to OnePageCRM](https://app.onepagecrm.com/add_new_contact?firstname=Jane&lastname=Doe&company=Acme%20Solar) |
| Alice      | Smith     | Acme       | [Add to OnePageCRM](https://app.onepagecrm.com/add_new_contact?firstname=Alice&lastname=Smith&company=Acme) |

Clicking a link opens OnePageCRM in a new tab with the Add Contact form
filled in.

## Supported parameters

| Parameter | Example | Notes |
| --- | --- | --- |
| `firstname` | `Jane` | |
| `lastname` | `Doe` | |
| `company` | `Acme Solar` | Matched to an existing company by name, or shown as a new one. |
| `job_title` | `Operations Lead` | |
| `background` | `Met at conference` | Background notes on the contact. |
| `address` | `123 Main St` | Street address. |
| `city` | `Galway` | |
| `state` | `Connacht` | |
| `zip_code` | `H91 ABC1` | |
| `country` | `IE` or `Ireland` | Two-letter country code or full country name. Invalid values are ignored. |
| `status` | `prospect` | Lowercase status name. Unrecognized values fall back to `lead`. |
| `phone[]` | `%2B353 91 555555` | Repeatable. Added as work numbers. |
| `email[]` | `jane.doe@acmesolar.example` | Repeatable. |
| `web[]` | `acmesolar.example` | Repeatable. |
| `tags[]` | `solar` | Repeatable. |

> If `company` matches an existing company (case-insensitive), the new
> contact inherits that company's status — and, when the account has
> tag sync enabled, its tags. Both override the `status` and `tags[]`
> parameters in the URL.

**Not supported:** custom fields. A `lead_source` parameter is
accepted but ignored — lead source can't be prefilled this way.

> Older versions of these docs said address fields weren't supported.
> They are now: `address`, `city`, `state`, `zip_code`, and `country`
> all prefill the form.

### Repeatable parameters

`phone`, `email`, `web`, and `tags` accept multiple values. Pass each
value as a separate `[]` parameter:

```
https://app.onepagecrm.com/add_new_contact?firstname=Jane&tags[]=solar&tags[]=q3-pipeline&email[]=jane.doe@acmesolar.example&email[]=jane@example.com
```

A single bare value (`phone=555555`) works too.

### Full example

```
https://app.onepagecrm.com/add_new_contact?firstname=Jane&lastname=Doe&company=Acme%20Solar&job_title=Operations%20Lead&background=Met%20at%20conference&address=123%20Main%20St&city=Galway&country=IE&status=prospect&phone[]=555555&email[]=jane.doe@acmesolar.example&web[]=https%3A%2F%2Facmesolar.example&tags[]=solar
```

URL-encode the values you pass in (spaces become `%20`, ampersands
become `%26`, `+` in phone numbers becomes `%2B`) and you're good.

## Need more than a prefilled form?

To create contacts programmatically — no form, no signed-in user — use
`POST /contacts` on the [REST API](/api/reference/). Start with the
[quickstart](/getting-started/quickstart/).