Create a contact via URL parameters

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
Alice	Smith	Acme	Add to OnePageCRM

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. Start with the quickstart.