Added in API level 1
Deprecated in API level 5

Insert

Kotlin |Java

class Insert

kotlin.Any
↳	android.provider.Contacts.Intents.Insert

Convenience class that contains string constants used to create contact Intents.

Summary

Constants
static String	`ACTION` The action code to use when adding a contact
static String	`COMPANY` The extra field for the contact company.
static String	`EMAIL` The extra field for the contact email address.
static String	`EMAIL_ISPRIMARY` The extra field for the email isprimary flag.
static String	`EMAIL_TYPE` The extra field for the contact email type.
static String	`FULL_MODE` If present, forces a bypass of quick insert mode.
static String	`IM_HANDLE` The extra field for an IM handle.
static String	`IM_ISPRIMARY` The extra field for the IM isprimary flag.
static String	`IM_PROTOCOL` The extra field for the IM protocol
static String	`JOB_TITLE` The extra field for the contact job title.
static String	`NAME` The extra field for the contact name.
static String	`NOTES` The extra field for the contact notes.
static String	`PHONE` The extra field for the contact phone number.
static String	`PHONETIC_NAME` The extra field for the contact phonetic name.
static String	`PHONE_ISPRIMARY` The extra field for the phone isprimary flag.
static String	`PHONE_TYPE` The extra field for the contact phone number type.
static String	`POSTAL` The extra field for the contact postal address.
static String	`POSTAL_ISPRIMARY` The extra field for the postal isprimary flag.
static String	`POSTAL_TYPE` The extra field for the contact postal address type.
static String	`SECONDARY_EMAIL` The extra field for an optional second contact email address.
static String	`SECONDARY_EMAIL_TYPE` The extra field for an optional second contact email type.
static String	`SECONDARY_PHONE` The extra field for an optional second contact phone number.
static String	`SECONDARY_PHONE_TYPE` The extra field for an optional second contact phone number type.
static String	`TERTIARY_EMAIL` The extra field for an optional third contact email address.
static String	`TERTIARY_EMAIL_TYPE` The extra field for an optional third contact email type.
static String	`TERTIARY_PHONE` The extra field for an optional third contact phone number.
static String	`TERTIARY_PHONE_TYPE` The extra field for an optional third contact phone number type.

Public constructors
`Insert()`

Constants

ACTION

Added in API level 1

static val ACTION: String

Deprecated: see android.provider.ContactsContract

The action code to use when adding a contact

Value: "android.intent.action.INSERT"

COMPANY

Added in API level 1

static val COMPANY: String

Deprecated: see android.provider.ContactsContract

The extra field for the contact company.

Type: String

Value: "company"

EMAIL

Added in API level 1

static val EMAIL: String

Deprecated: see android.provider.ContactsContract

The extra field for the contact email address.

Type: String

Value: "email"

EMAIL_ISPRIMARY

Added in API level 1

static val EMAIL_ISPRIMARY: String

Deprecated: see android.provider.ContactsContract

The extra field for the email isprimary flag.

Type: boolean

Value: "email_isprimary"

EMAIL_TYPE

Added in API level 1

static val EMAIL_TYPE: String

Deprecated: see android.provider.ContactsContract

The extra field for the contact email type.

Type: Either an integer value from ContactMethodsColumns or a string specifying a custom label.

Value: "email_type"

FULL_MODE

Added in API level 1

static val FULL_MODE: String

Deprecated: see android.provider.ContactsContract

If present, forces a bypass of quick insert mode.

Value: "full_mode"

IM_HANDLE

Added in API level 1

static val IM_HANDLE: String

Deprecated: see android.provider.ContactsContract

The extra field for an IM handle.

Type: String

Value: "im_handle"

IM_ISPRIMARY

Added in API level 1

static val IM_ISPRIMARY: String

Deprecated: see android.provider.ContactsContract

The extra field for the IM isprimary flag.

Type: boolean

Value: "im_isprimary"

IM_PROTOCOL

Added in API level 1

static val IM_PROTOCOL: String

Deprecated: see android.provider.ContactsContract

The extra field for the IM protocol

Type: the result of Contacts.ContactMethods.encodePredefinedImProtocol or Contacts.ContactMethods.encodeCustomImProtocol.

Value: "im_protocol"

JOB_TITLE

Added in API level 1

static val JOB_TITLE: String

Deprecated: see android.provider.ContactsContract

The extra field for the contact job title.

Type: String

Value: "job_title"

NAME

Added in API level 1

static val NAME: String

Deprecated: see android.provider.ContactsContract

The extra field for the contact name.

Type: String

Value: "name"

NOTES

Added in API level 1

static val NOTES: String

Deprecated: see android.provider.ContactsContract

The extra field for the contact notes.

Type: String

Value: "notes"

PHONE

Added in API level 1

static val PHONE: String

Deprecated: see android.provider.ContactsContract

The extra field for the contact phone number.

Type: String

Value: "phone"

PHONETIC_NAME

Added in API level 3
Deprecated in API level 5

static val PHONETIC_NAME: String

Deprecated: see android.provider.ContactsContract

The extra field for the contact phonetic name.

Type: String

Value: "phonetic_name"

PHONE_ISPRIMARY

Added in API level 1

static val PHONE_ISPRIMARY: String

Deprecated: see android.provider.ContactsContract

The extra field for the phone isprimary flag.

Type: boolean

Value: "phone_isprimary"

PHONE_TYPE

Added in API level 1

static val PHONE_TYPE: String

Deprecated: see android.provider.ContactsContract

The extra field for the contact phone number type.

Type: Either an integer value from PhonesColumns, or a string specifying a custom label.

Value: "phone_type"

POSTAL

Added in API level 1

static val POSTAL: String

Deprecated: see android.provider.ContactsContract

The extra field for the contact postal address.

Type: String

Value: "postal"

POSTAL_ISPRIMARY

Added in API level 1

static val POSTAL_ISPRIMARY: String

Deprecated: see android.provider.ContactsContract

The extra field for the postal isprimary flag.

Type: boolean

Value: "postal_isprimary"

POSTAL_TYPE

Added in API level 1

static val POSTAL_TYPE: String

Deprecated: see android.provider.ContactsContract

The extra field for the contact postal address type.

Type: Either an integer value from ContactMethodsColumns or a string specifying a custom label.

Value: "postal_type"

SECONDARY_EMAIL

Added in API level 3
Deprecated in API level 5

static val SECONDARY_EMAIL: String

Deprecated: see android.provider.ContactsContract

The extra field for an optional second contact email address.

Type: String

Value: "secondary_email"

SECONDARY_EMAIL_TYPE

Added in API level 3
Deprecated in API level 5

static val SECONDARY_EMAIL_TYPE: String

Deprecated: see android.provider.ContactsContract

The extra field for an optional second contact email type.

Type: Either an integer value from ContactMethodsColumns or a string specifying a custom label.

Value: "secondary_email_type"

SECONDARY_PHONE

Added in API level 3
Deprecated in API level 5

static val SECONDARY_PHONE: String

Deprecated: see android.provider.ContactsContract

The extra field for an optional second contact phone number.

Type: String

Value: "secondary_phone"

SECONDARY_PHONE_TYPE

Added in API level 3
Deprecated in API level 5

static val SECONDARY_PHONE_TYPE: String

Deprecated: see android.provider.ContactsContract

The extra field for an optional second contact phone number type.

Type: Either an integer value from PhonesColumns, or a string specifying a custom label.

Value: "secondary_phone_type"

TERTIARY_EMAIL

Added in API level 3
Deprecated in API level 5

static val TERTIARY_EMAIL: String

Deprecated: see android.provider.ContactsContract

The extra field for an optional third contact email address.

Type: String

Value: "tertiary_email"

TERTIARY_EMAIL_TYPE

Added in API level 3
Deprecated in API level 5

static val TERTIARY_EMAIL_TYPE: String

Deprecated: see android.provider.ContactsContract

The extra field for an optional third contact email type.

Type: Either an integer value from ContactMethodsColumns or a string specifying a custom label.

Value: "tertiary_email_type"

TERTIARY_PHONE

Added in API level 3
Deprecated in API level 5

static val TERTIARY_PHONE: String

Deprecated: see android.provider.ContactsContract

The extra field for an optional third contact phone number.

Type: String

Value: "tertiary_phone"

TERTIARY_PHONE_TYPE

Added in API level 3
Deprecated in API level 5

static val TERTIARY_PHONE_TYPE: String

Deprecated: see android.provider.ContactsContract

The extra field for an optional third contact phone number type.

Type: Either an integer value from PhonesColumns, or a string specifying a custom label.

Value: "tertiary_phone_type"

Public constructors

Insert

Added in API level 1

Insert()

Deprecated: see android.provider.ContactsContract

Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Last updated 2025-02-10 UTC.

X
Follow @AndroidDev on X
YouTube
Check out Android Developers on YouTube
LinkedIn
Connect with the Android Developers community on LinkedIn